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DOS/VS Serviceability Aids and Debugging Procedures 

THIS MANUA L... PR E FACE 

... is intended to guide System/370 operators and programmers using DOS/VS in 
determining and isolating the cause of a system malfunction. 

METHOD OF PRESENTATION 

Serviceability aids and how to use them are described in this manual through 
extensive use of diagrams and examples. This enables fast retrieval of information 
and largely avoids the need to use other publications in order to analyze the dumps 
and printouts discussed. 

Contents and addresses shown in the illustrations are subject to change and are 
shown only as an aid to offline debugging of DOS/VS release 29.. IBM will not be 
responsible for any system malfunction resulting from a change made by the 
user of any contents or addresses of the tables and blocks described. 

SUBJECTS COVERED 

There are four major sections; 

SECTION 1: Introduction , introduces the serviceability aids detailed in Section 2, 
and the debugging procedures described in Sections 3 and 4. 

SECTION 2: Serviceability Aids, describes in detail the serviceability aids, 
showing in flowchart form how to use them, and recommending when to use them. 
Examples show how to analyze dumps and printouts in conjunction with the 
debugging procedures of Section 3 and 4. 

SECTION 3: Debugging for Operators, consists of flowcharts that help the 
operator to isolate the cause of a system malfunction. The operator is instructed 
when to use the procedures of Section 2 to ensure that information is gathered 
from the system. 

SECTION 4: Debugging for programmers, this section is divided into two parts: 

Part 1 consists of checklists in flowchart form that recommend the method of 
analysis and choice of serviceability aids best suited to isolate the cause of a given 
type of system malfunction. An indication is made on the flowcharts when it is 
considered necessary to inform your IBM customer engineer when it is not 
possible to isolate the cause of an error. System information to be saved for the 
IBM CE is also listed at these points in the flowcharts. 

Part 2 is a general description of the DOS/VS supervisor/problem program interface 
tables, information blocks and save areas. It shows how to locate these areas in a 
dump, and how to analyze the data during offline program debugging. Debugging 
aids for high level languages are described in publications dealing with the specific 
language. 

PREREQUISITE KNOWLEDGE 

Operators using this manual must be familiar with the following IBM publications: 

DO SI VS Operating Procedures GC33 - 53 78 

DOS/VS Messages GC33 - 5379 

Programmers using Section 4 must be familiar with the following IBM publications: 

IBM System 1 3 70 Principles of Operation GA 22 - 7000 

DOS/ VS System Management Guide GC33 - 53 71 

Other IBM pubhcations referenced in this manual are Usted in the bibliography at 
the back. 
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during 
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ERROR observed 

WHILE job (program) 
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IN RESULT of job (program) 
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Chart 02 Section 3 


Chart 01, Section 4 


Debugging for 
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the Operator. 
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HIR Hardware Instruction Retry 
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Serviceability Aids and Debugging Procedures 



Hands-on debugging 



Detect and 
categorize 
the error. 



+ 



Gather information 
using serviceability aids. 




Offline debugging 



Analyze the 
information. 
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Use special "tools' 
if further error 
isolation required. 
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1 .2 Introduction 






Serviceability Aids 



Serviceability aids are "tools" offered by IBM and are designed to gather system 
information whenever a malfunction occurs on a System/370, 

A malfunction can be caused by a programming error or by a hardware failure. 

Some of the serviceability aids that gather system information when 
programming errors occur are: 

• DUMPS of specified real and virtual address areas 

• DUMPS or DISPLAYS of general registers, 

control registers, 

floating point registers, and 

program status words 

• FORMATTED PRINTOUT of the DOS/VS supervisor tables and 
information blocks 

• The abihty to ALTER any register or any area of virtual storage 

• Problem determination aids, PDAIDS (event tracing routines) 

• System debugging aids, SDAIDS (program event recording and 
tracing routines) 

• Disk and tape LABEL INFORMATION display programs 

• LISTIO and MAP commands (aids that list devices used per partition, 
and that map virtual storage organization during system operation) 

• Commands that allow information contained on disk files using VSAM 
(Virtual Storage Access Method) to be printed, listed, or verified 

• Programs that display libraries and allow them to be edited and 
maintained 

• Error messages issued by the system that inform the operator about 
the nature of an error. 

The serviceability aids that detect hardware failures and produce formatted output 
concerning this failure are: 

• RMS — Recovery Management Support 

• EREP - Environmental Recording, Editing, and Printing 

• OLTEP - Onhne Test Executive Program 

• SEREP - Stand-alone EREP 

• Micro-program diagnostic aids, (Models 115, 125, and 158) 

In addition to the above aids, the Models 115 and 125 are provided with a micro- 
program recording facility that records certain types of hardware errors on 
DISKETTE. The errors recorded on DISKETTE can be displayed and analyzed 
by the IBM CE using the Maintenance Program Selection and Log Analysis displays. 

A similar facility is provided on the Model 158 in the form of displays obtained 
by the use of the Service function. 

A reference chart at the front of Section 2 lists the IBM serviceability aids, which 
are described in detail in that section. 

Serviceability aids offered by IBM that are designed to gather system information 

specifically for use with high-level languages (RPG II, PL/I, American National 

Standard COBOL, and FORTRAN) are not described in this manual. Details about Introduction. ' 1 .3 

these aids are found in the corresponding manuals for the processor being used. 



What is Debugging! 



Debugging is a procedure that is followed to isolate an error (sometimes referred 
to as a bug) that prevents programs from being correctly executed by a computer 
system. 

Debugging requires the coordinated efforts of operators and programmers, and is 
divided into two distinct actions: 

• Hands-on debugging 

• Offline debugging. 

Hands-on debugging entails the examination of available symptoms and 
indications and the saving of information by the operator when a system 
malfunction occurs. 

Offline debugging requires the analysis and the isolation of an error by the 
programmer, using data gathered during hands-on debugging. 

IBM has provided special programs, commands, and procedures called service- 
ability aids, or tools, to help in gathering information about a system malfunction. 
These aids can be initialized by the operator and are of special interest when an 
error is obscure. 

The two debugging actions (hands-on and offline) can be divided into the 
following four phases as shown in figure 1.1: 

1. Determine the type of malfunction. 

2. Gather information. 

3. Analyze the information. 

4. Use aids for further error isolation if required. 
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OPERATORS 



What is Debugging? 



Phase 1 



Recognize the error type: 

Unintended loop 
Wait state 
Incorrect output 
Program checl<s 
I/O device errors 
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Phase 2 

Gather information: 

Messages from SYS LOG 

Line printer output 

Dumps 

A MAP of virtual storage 

A LISTIO of I/O device 

assignments 

Low address storage 
System activity 
Indicator lamps 
EREP or SEREP output 
Models 115/125 Log 
analysis displays 
Model 1 58 display frames 
Loop traces 





Program logic 



Error messages 
and Dumps 
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Figure 1-1 . The four phases of debugging 



PROGRAMMERS 



Phase 3 

Isolate the error: 

Error messages 
JCL errors 
Incorrect macros 
Linkage editor errors 
Source code errors 
Loop traces 
I/O data file errors 
Flowcharting errors 
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Phase 4 



Further error isolation: 

Trace routines 

Operator's console 

Supervisor communication 

macros 

Library and Service programs 
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System Malfunctions 



Generally speaking, a system malfunction is said to have occurred whenever a 
program did not do what it was expected to do. A system malfunction can be 
due to one or more of the following: 

• An operator error or job set (JCL) 

• An error in the program logic, a coding error, or 
the misuse of instructions 

• A hardware failure 

• An unusual circumstance during program execution. 

Because of the many circumstances in which errors may occur, system malfunctions 
manifest themselves in different ways. 

The physical size of a given system, its environment, and the type of programs used 
also play a part in how a particular error affects system operation. 
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During single-partition batch jobs (BJ) 

In this type of environment, the easiest way to recover from an error is to cancel 
the job and begin it again from the IPL procedure. However, to deal with a 
program that has been operating successfully for several hours prior to the error, 
alternative methods must be used. 

Also in this type of environment, operators "get to know" the programs and can 
recognize when the programs do not appear to be performing the same as before. 
Hands-on debugging can be performed without interfering with the execution 
of other jobs. 



Multiprogramming environment (MPS) 

To cancel, re-IPL, and restart jobs after a malfunction in this type of environment 
would delay both production and debugging procedures. Hands-on debugging is 
more difficult than with BJ, and the method used to gather information must be 
carefully chosen. It is also impossible to "get to know," by repeated use of the 
same programs, exactly what each job should be doing at any given time, and so it 
is more difficult to recognize a system malfunction. 



Teleprocessing (TP) 

Since teleprocessing is normally executed on multi-programming systems, the 
same problems are met as those described under MPS. Additionally, the 
cancellation of jobs is more difficult. The difficulty increases in proportion to the 
number of terminals online, and the number of active partitions, when the mal- 
function occurred. Hands-on debugging cannot be attempted without informing 
and affecting all the terminals. 



During program testing 

Although systems may not be large or complex in this type of environment, it is 
less likely that the operator will know the programs. In this environment, the 
testing of new programs and the simulation of space flights, aircraft structures, 
traffic controls systems, etc., are carried out daily, with unpredictable results in 
most cases. Hands-on debugging can be done only by the programmer. Even 
recognizing a system malfunction is in itself difficult. Gathering the right 
information is of paramount importance, to enable the programmer to debug 
offline. 

The previous paragraphs indicate that when a system malfunction occurs, the 
operator must be able to recognize it as such, decide on whether or not to use 
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System Malfunctions 



hands-on debugging to make a possible recovery, and decide on the best method of 
gathering information that will help the programmer. 

A description follows of the main types of system malfunctions, how to recognize 
them, and how to treat them. 
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Type of Malfunctions 

LOOPS Definition 



A loop in a program is tlie repetitive execution of a sequence of CPU (central 
processing unit) instructions. 

If the number of instructions in the loop is small, the loop is referred to as being 
small, short, or tight. When a loop consists of many instructions, which may also 
include input/output operations, the loop is often referred to as long. 



Types of loops 

A part of a program may be repeated a number of times, thus creating a programmed 
loop. A programmed loop is often referred to as a processing loop. Sometimes a 
program error causes the CPU to repeat part of a program endlessly. Such a loop is 
never intended and requires debugging procedures to isolate the error. 

Recognizing a loop 

One or more of the following may indicate that a job/program is in an unintended 
loop: 

• A steady glow of lights on the system Models 115, 125, and 158, control 
panel with the SYS indicator on, or for the System/370 one address will appear 
to remain displayed on the video display unit. (This depends on whether the 
loop is long or short.) 

• A rhythmic pattern in the lights on the system control panel, or for the 
Models 115, 125, and 158, the word WAIT may flicker on the video display 
unit. 

• A pointless recurrence of I/O (input/output) activity. 

• A job (program) that does not change status for a long time (for example, an 
absence of I/O activity). 

A note to the operator: When a loop is recognized, the operator must first try to 
establish whether the loop is unintended or has been programmed, before beginning 
with hands-on debugging. 

If the programmer has not warned the operator about a programmed loop, or given 
a time estimate for the program, it will be very difficult to differentiate between 
an unintended loop and a programmed loop. 

Even when time estimates are given, job or program time may increase because of 
any one or more of the following: 

• Priority of the partition in which the job is ruiming (multiprogramming 
system) 

• CPU retry and error logging routines 

• The use of slower speed input/output units than those for which the job was 
originally planned. 

Causes of an unintended loop 



A coding or logic error in the program may cause an unintended loop. 

The operator may have set the job up incorrectly, thus causing the program 
to loop at some stage during execution. 



• An input/output device malfunction. 

• A JCL (job control language) error. 
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Operator action LOOPS 

If the operator is not sure whether the loop is unintended, the programmer must 
be contacted before any debugging procedures can begin. If this is not possible, 
the only action the operator can take is to let the job run on for a time, depending 
on system commitments, and to make notes of any further system activity. If the 
loop is programmed, no time would have been lost by allowing it to run on. In 
multiprogramming environments a loop in one partition will affect the run times 
of programs in other partitions. 

Flowcharts in Section 3 will help the operator in gathering information at the 
time the error occurs, and Section 4 provides a guide for programmers in how to 
analyze this information. 
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Types of Malfunctions 

WAIT STATES 



Definition 

There are occasions when an error in the program or the machine causes the 
system to stop. This means that no I/O activity is occurring and no instructions 
are being executed. 

In this state the hardware circuitry turns on the WAIT indicator, or on the 
System/370 Models 115, 125, and 158, displays the word WAIT on the video 
display unit, and the system is said to be in a wait state. 
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Types of wait states 

The impact of a wait state on system operation depends on the cause of the wait 
and the operator action required to recover from it. The following terminology 
is used for describing a wait state: 

• Hard wait 

• Soft wait 

• Normal wait 

Essentially, the difference between the first two waits is that the system 
recovery from a hard wait is impossible without executing a system IPL, whereas 
recovery from a soft wait may be accomplished without impairing program or 
system operation. The operator can easily determine the type of wait state by 
pressing the REQUEST key. If the wait is soft the following message may be 
issued: 

AR 1I60A READY FOR COIVIMUNICATIONS 



When the system is waiting for operator response to a message printed on the 
console printer or for an I/O device to be made ready by operator action, 
the wait state is sometimes referred to as normal. 



Recognizing a Wait State 

Any of the following observations confirm that the System is in a wait state: 

• WAIT indicator remains on, or for a System/370 Models 1 15, 125, and 158, 
the word WAIT remains displayed on the video display unit. 

• SYS indicator remains off (See Figure 1-2). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators are on. 

• A HARD MACHINE CHECK message is printed on the console printer. 

• A HARD WAIT coded message in general register 1 1 (X'B'). 

• A HARD WAIT coded message in bytes 0-3 of low address storage. 
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Causes of a soft wait 

A soft wait may be the result of an I/O operation performed on a malfunctioning 
device that is unable to complete an operation. 

A system waiting for a magnetic tape unit to rewind a tape reel or for a disk unit 
to finish a seek before continuing a program, is in a temporary soft wait. 
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WAIT STATES 



Recovery from a soft wait 

If the system is in a soft wait, it is waiting for an interrupt to signal the completion 
of an event. Although the expected interrupt may be from the timer or external 
interrupt key, a missing "device-end" caused by hardware is the most frequent 
cause. The operator can make each device not-ready, then ready, to generate a 
device-end interrupt from each device. The system light flashes briefly as the 
supervisor examines and discards interrupts for which it was not waiting. The 
interrupt from the device for which the system is waiting causes normal processing 
to continue. (The occurrence should be brought to the attention of the customer 
engineer as a possible hardware failure.) 

It may be possible to isolate the cause of the wait and take alternative action, such 
as using a different I/O device. 

Recovery from a wait state becomes more important on large online multi- 
programming systems where to cancel programs or to re-IPL may be disastrous. 
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Causes of a hard wait 

Hard waits can be caused by machine failure and programming errors. Possible 
programming errors that cause hard waits are: 

• Supervisors errors as the result of a program check while in the supervisor 
state 

• Coding errors in transient routines 

• Incorrect use of transient routines. 



Operator action 

If the hard wait has been caused by a hard machine check shown by a message on 
SYSLOG and/or a coded message in bytes 0-3 of low address storage (see note), 
the operator must gather information from the system to help the IBM customer 
engineer locate the error. 

If, however, there is no indication that the wait has been caused by a hard 
machine check, some information as to the cause of the wait can be obtained 
before retrying the job or starting a new one. 

In any case certain initial checks must be made on the setup procedures for the 
job, the input media in use, and I/O devices in use. 

Flowcharts in Section 3 will help operators in carrying out initial system checks 
and in gathering data about the wait state, and Section 4 provides a guide for 
programmers in how to analyze the data. 

Note: For the Models 115 and 125 that are not supporting MCAR/CCH, a coded 
message is placed in GRll. A complete list of coded messages is given in Section 2. 
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INDICATORS FOR 
LOOPS AND 
WAIT STATES 



The SYS, MAN, and WAIT indicators show the CPU and 
I/O operating states as follows: 
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layout 
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INDICATOR 


FUNCTION 


SYS* 


The SYSTEM indicator is on when CPU operations are 
in progress and either use meter is running. 


MAN * 


The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 


WAIT * 


The WAIT indicator is on when the system is in a wait state 
(CPU clock running but no instruction processing taking 
place). If the wait is a soft wait state and an interrupt 
occurs, the CPU is taken out of wait state and processing 
started under control of the program being executed. 



* These indicators do not exist on System/370 Models 115, 
125, and 158. Instead the corresponding words are displayed 
on the display unit. 
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Legend 

O-off 



-On 



Figure 1-2. System indicators. 

Aids for recognizing a loop or a wait state. 
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Definition INCORRECT 

T ... f ■ .V u ■ . OUTPUT 

Incorrect output can range from incorrect line spacing on the printed output 

from a line printer to incorrect results of calculation written on a disk file. 

Recognizing incorrect output 

Incorrect output may be detected by: 

1 . Operator 
Invalid messages 1 Ton console printer(s) 
Unidentified data v 4 line printer(s) 
Duplication of data J I display unit(s) 
Lack of activity on I/O devices assigned as output units 
Either more or less I/O activity than expected. 

2. Programmer 

If the execution of a program has been apparently successful, incorrect results 
will not be detected until the data is used at some future time. 
Incorrect output can be categorized as: 

• Missing records 

• Duplicate records 

• Invalid data that has sequence errors, incorrect values, format errors, or 
meaningless information. 

Causes of incorrect output 

As well as errors in the program logic, mistakes in setting up the system for the 
program will cause errors in the output. For example, use of incorrect data for 
input files, mistakes in device assignments, and incorrect job control statements and 
commands in the job stream will cause unexpected output. 

Operator action 

If the programmer cannot be contacted, the operator must save the output (what- 
ever it is) or make a note of system activity before cancelling the job, or both. 

The work files and input data should be given to the programmer together with 
any dumps executed. It may also be necessary to re-submit the job and trace the 
logic flow by using the SDAID BR and/or IF trace. 

Flowcharts in Section 3 and 4 indicate the serviceabiUty aid to use for isolating the 
cause of this type of system malfunction. 
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INTERMITTENT 
ERRORS 



Definition 

An error which occurs once and then seems not to recur for some time, is said 
to be intermittent. The frequency of the error may be a fraction of a second in 
the case of a high-speed computer Hke the System/370, or a week, a month, a year, 
or even longer. Intermittent errors can be caused by hardware failures or by 
programming errors. 



Hardware failures 

IBM provides serviceabiUty aids that record and analyze hardware failures and 
attempt to recover from them. The routines that perform these functions are 
collectively termed RMS (Recovery Management Support). If online recovery is 
impossible, the system may be placed in a hard wait state. A message is issued to 
the system operator to run either the SEREP or EREP program. The output 
obtained from either of these programs is a hsting of the statistical data accumu- 
lated up to and including the time of the error. This information serves not only as 
an aid in diagnosing machine errors, but also helps IBM customer engineers to 
increase the Reliability, Availability, and Serviceability (RAS) of the system. 

RMS does not affect system operation, except for the time required to record the 
failure and issue an informatory message on SYSLOG. 

• Note: By use of the MODE command the recording and printing of soft 
machine checks can be suppressed. (This is not applicable to the 
Models 115 and 125). 

If the retry of an error is not successful and the severity of the error prevents 
system operation, the machine attempts to issue the message 

OTl IW HARD WAIT CODE = X (where X is an alpha character A thru I) 
and the system is placed in a hard wait state. Diagnosing this condition is described 
in Sections 2 and 3. 

On the System/370 Models 115 and 125 statistical data about the hardware is 
recorded on the DISKETTE by micro-program. The recorded data on the DISKETTE 
can be displayed on the video display unit by selecting one of the LOG ANALYSIS 
displays. This is described more fully in Section 2 — F in this manual. The 
information displayed supplements the EREP/SEREP program output that may 
also be required, depending on the type of I/O units attached to the systems. If 
a hard wait occurs with no message on the console printer, there may be a message 
in "low address storage" that wiU indicate an operator action. Low address 
storage and its meaning is fully discussed in Section 2. 
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Intermittent programming errors 

After writing a program, it is in most cases quite impossible to test it under all 
combinations of circumstances that may occur during its use. Therefore, 
programs may contain coding errors that become evident only under particular 
circumstances, even after years of error-free use. 

Since the error does not occur every time the program is executed, and the EREP 
printout or Log Analysis display indicates no hardware failures, this type of 
system malfunction is regarded as an intermittent software error. 

Such an error can be caused by a combination of the following: 

• A change in the input data (a new card deck) 

• Poor quality input media (cards, tape, data transmission) 

• An existing coding error in a routine that is not normally executed 

• A change of routines called by the supervisor 

• The use of a new software routine 

• New operating procedures 

• Changes in the job control language. 

An error of this type is difficult to isolate, and requires the use of special 
debugging techniques. 



Definition 

There are three types of program check interrupts: 

1. A page translation exception. This occurs when an instruction or data is not 
in the real address area. A page from the page data set must be 'paged in' to 
the real address area before the program can continue. This is not an error 
condition. 

2. Program check interrupt resulting from the use of the MC (monitor call) 
instruction. This is not an error condition. 

3. Program check interrupt resulting from incorrect specification or use of an 
instruction or data by the problem program. This is an error condition, and is 
always reported by a message issued on SYSLOG at the time of the program 
check as shown below: 



Types of Malfunctions 

PROGRAM CHECK 
INTERRUPT 



BG 0S03I PROGRAM CHECK INTERRUPTION - HEX LOCATION 0406E0 - 
CONDITION CODE 3- DATA EXCEPTION 
OSOOI JOB DEBUGEXS CANCELED 

The program is automatically cancelled by the supervisor and depending on the 
use of the job control statement / / OPTION DUMP, or the DUMP option being 
supported by the supervisor, a dump of the supervisor and of the partition owning 
the program is executed. This automatic program cancellation is termed abnormal 
EOJ (end of job), or program abnormal end. The program check message gives 
the location of the failing operation and the condition code. This gives the pro- 
grammer a starting point for offline program debugging. 



Causes of a program check 

The most probable cause is improper specification or incorrect use of instructions 
or data in the program. 

Program checks occur most frequently during program testing, because of 
incorrect coding or errors in the program logic. 



Operator action 

No action can be taken by the operator other than saving for the programmer the 
console printer log sheet, the dump (if executed), job stream, and any input 
data files used by the failing program. Flowcharts in Section 4 will help the 
programmer to analyze the information and isolate the error. 
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I/O DEVICE 
MALFUNCTIONS 



A device malfunction either will be seen immediately as an incorrect physical 
operation, or will cause the system to enter a wait state, loop, or produce 
incorrect output as already discussed. Normally an error message will be 
issued on SYSLOG. 



Examples of device malfunctions 

Some obvious device malfunctions are: 

• Mechanical noises not normally present 

• Lamps either on or off which the operator recognizes as not normal conditions 

• A lack of movement of input/output media which the operator knows to be 
incorrect at the time 

• "Tape Runaway," a special type of error that occurs on magnetic tape drive unit 
(A mounted tape winds forwards at a higher speed than normal.) 

• Incorrect "form skipping" on the line printer. 



Operator action 

If there is no obvious action that can be taken such as pressing the device STOP 
and/or OFF buttons, consult the device component manual before informing 
your IBM customer engineer (unless the nature of the malfunction constitutes 
a danger to human lives and equipment). 
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Gathering Information 



When a system malfunction is recognized it is important that the operator obtain 
information from the system. The information helps the programmer and the IBM 
customer engineer during offline program debugging. Whatever the system mal- 
function, the operator must always save error messages issued on SYSLOG and/or 
on SYSLST, and in some cases save the I/O media (card files). 

The operator can obtain information by doing one or more of the following: 

• Issue the MAP command. 

• Make a note of system activity. 

• Display low address storage, the current PSW, the control registers and 
general registers. 

• Execute a storage dump. 

• Take a trace of a loop. 

• On the Models 135, 145, 155-11, and 158, initiate the ERE? or SERE? 
: programs 

• On the Models 1 15 and 125 on the advice of the IBM CE use the Log 
Analysis to display hardware errors recorded on the DISKETTE, 
and on the Model 158 use the display frames. 

Many factors must be considered when gathering information, and Section 3 and 4 
cover this subject in detail. 
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Gathering Information 



LOW ADDRESS 
STORAGE 



This area of low real storage (as defined in the Introduction to DOS/VS) is one of 
the important sources of system information used to aid offline program debugging. 
The contents of the low address storage can be dumped (printed out) or displayed 
by using job control commands or console aids. Details about the format and 
contents of the low address storage are given in Section 2-E of this manual. 
Figure 1-3 illustrates the location of low address storage in relation to other areas 
in virtual storage. 



Wait state messages 
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CAW 
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LOW ADDRESS STORAGE 


SUPERVISOR 


PROGRAM A 


PROGRAM B 


PROGRAM C 


PROGRAM D 


PROGRAM E 
HIGH ADDRESS STORAGE 






Figure 1-3. Relative location of low address storage. 

Low address storage contains information to aid offline debugging 
(Size relationships in this figure are purely illustrative.) 



C>^ 



1.18 Introduction 



Page of GC33-S 380-1, 
revised June 30, 1974 
by TNL SN33-8780 ' 



A dump is a program or an operation that prints the image, in hexadecimal format, 
of a selected area of virtual storage. This term is also used when an area of virtual 
I storage is recorded or stored on magnetic tape or on a disk pack 

Figure 1 -4 illustrates the various type of dumps offered by IBM. Section 2- A of 
this manual describes how to execute the dump programs and operations, and 
discusses the meaning of dump output that is useful during offline program 
. debugging. 



Gathering information 

STORAGE 
DUMPS 



jr>^ 



A dump of the i 

real address area. "S^ 

Stand-alone dump. 



Real 


, 


address 




area 




Virtual 




address 




area 





^ffiSS^^ 



A dump of the 
virtual address area. 
SYS VIS dump. 
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LOW ADDRESS STORAGE 



SUPERVISOR 



PROGRAM A 



PROGRAM C 



PROGRAM D 



PROGRAM E 




A dump or display of the 
low address storage. 

Attention routine commands 
and operator's console. 



A dump of a partition in the 
real or virtual address area. 
This is referred to as a 
Partition dump or a System 
dump and includes a dump of 
the supervisor area. 
System generation option, 
job control statement, job 
control command, and 
assembly macros. 



A snap shot dump used to 

display small parts of a 

program at any selected 

area. 

Attention routine commands and 

assembly language macros. 



A dump of the SVA 

Partition dump or a System 
dump includes a dump of 
the SVA (or part of it) if 
a program check occurs 
in the SVA. 



Figure 1-4. Storage dumps. 

Various areas of storage can be dumped or displayed using the IBM dump 
programs and console aids. 

(The dividing point between real and virtual address areas depends on the size 
of the hardware memory on your System/370). 



Introduction 



1.19 



Gathering Information 

LOOP TRACING 



Three methods of tracing or recording the path of a loop are provided on the 
System/370: 

1 . By using the facilities provided by the operator's console, the operator can 
list the addresses of the instructions used by the loop. 

2. By using the successful branch routine of the SDAIDS. 

3. By using the instruction fetch trace of the SDAIDS. 

All three methods are described in Section 2. The first method is useful to trace 
small loops during hands-on debugging. However, the amount of time that may be 
spent tracing a loop by this method depends on the answer to the following: 

1. How important is it to system operation that the loop be fully traced? 

2. How will the time spent tracing the loop affect system commitments? 
Normally the operator is not in a position to answer these questions and if the 
programmer or the DP manager is not available, he can only take a short trace. 
The second and third methods can be used either during hands-on debugging, or 
during re-runs of the program generating the loop. 






A note to operators 

Before tracing a loop by using any of the above methods, you must consider their 
effects on time-dependent programs currently running in the system. Such 
programs are, for example, those using magnetic ink character recognition or 
teleprocessing equipment as input/output devices. 

Guidelines on how to isolate an unintended loop and trace it are given in 
flowcharts in Sections 2 and 3. 
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RMS (Recovery Management Support) HARDWARE ERROR 

RECORDING AND 

The functions employed in recording a hardware error and recovering from it are RECOVE R Y 

collectively termed RMS (Recovery Management Support). RMS was introduced 
under "Hardware failures" in this Section. RMS software routines record hardware 
failures on the system recorder file, located on SYSREC (SYSREC can be either 
an area on SYSRES, or an individual disk pack.) 

For the System/370 Models 1 15 and 125, errors in the CPU and natively attached 
input/output devices (except tape units and teleprocessing terminals), are recorded 
on the DISKETTE. Recording is performed by microprograms and is independent of 
the RMS software routines. 

Figure 1-5 contains an overview of RMS, which is a part of the total RAS 
(Reliability, Availability, and Serviceability) concept. RMS uses a monitor and 
several transient routines that check the severity of the error, record it (if possible), 
and print informatory messages. 

Using an IBM program called EREP (Environmental Recording, Editing, and 
Printing) the data on the recorder file can be printed on a line printer. This data 
is used to investigate the nature and cause of a system malfunction. For the 
Models 115 and 125, information will be printed by EREP only if the system 
supports RMS. (Refer to Section 2-F for details.) 

If the severity of a hardware error is such that EREP can not be executed, the IBM- 
supplied program SEREP must be executed. SEREP is a stand-alone version of 
EREP that formats and prints the data held in the logout areas of real storage. 

On the System/370 Models 115 and 125, the LOG ANALYSIS displays hardware 
statistical data recorded on the DISKETTE. This is additional to the EREP program 
that can be executed after using the log analysis displays. 

A similar facility is provided on the Model 158 in the form display frames obtained 
by the use of the SERVICE function. 

How to execute EREP and SEREP, and how to use the log analysis displays and 
display frames feature is described in Section 2. The components of RMS are fully 
described in Section 2-F. 
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Hardware error 



Error detection, correction, and 
recovery by hardware microprogram 



Machine check interrupt 
generated for CPU error, 
main storage and control 
storage errors. 



I/O interrupt generated 
for I/O channel and device 
errors. 




For System/370, Model 1 15/125 
record error on DISKETTE and 
SYSREC. For iVIodels 135, 145, 
1 55-1 1 , and 1 58, log error in 
the LOGOUT areas of real storage. 



Automatic System Action 
{depends on severity of error) 




Saves data about the error 

in registers 

Continues processing in a 

degraded mode 

On Models 115/125/158 

recording on DISKETTE 

occurs 



Automatic system action 



RMS 
Software -^ 
Routines 



Re-analyze 
data about 
the error. 



Tries to record data about the 
error on the system recorder. 



Tries to print a message on 
SYSLOG to inform operator 
about the type of error. 
Places system in a hard wait. 



Automatic system action 




Records data about the error 
on the system recorder file. 



Cancels the job in which 

the error occurred. 

Prints a message on SYSLOG 

to inform the operator of 

system action. 

Continues processing with 

next job. 



Automatic system action 



Records data about the 
error on the system 
recorder file. 



Prints a message on SYSLOG 
to inform operator that a 
hardware error has occurred. 
Continues normal processing. 



Operator action 



For use by IBM 
customer engineers 
during scheduled 
maintenance 



For System/370, Models 1 15 and 
125, use the LOG ANALYSIS 
feature to display hardware 
statistical data and for Model 158 
use the display frames 



Figure 1-5. An overview of RMS, 

This illustration shows the general connection 
between the hardware and software components of 
hardware error recording and recovery functions. It 
also shows the connection between RMS and the 
EREP and LOG ANALYSIS programs. 



f 



Use EREP to print out 
the data about hardware 
errors recorded on the 
system recorder file. 



} 



the 



Programmer action 



IBM customer engineer's action 



Use the EREP printout to 
find out more about the 
system. 



Use EREP printouts to aid 
in hardware error diagnosis. 
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EREP (Environmental Recording, Editing, and Printing) 

This program edits and prints information about hardware failures that are 
recorded on the system recorder file (SYSREC). 

There are several options of EREP that enable the operator to select SYSREC 
records for editing and printing. These options are detailed in Section 2. By using 
the EREP program output, the IBM customer engineer can recognize hardware 
failures. During scheduled maintenance periods he can then perform preventive 
maintenance on the parts of the system causing hardware failures. 

Because the EREP program can be initiated by the operator, it is a useful aid for 
gathering data about the condition of the hardware at any time during 
system operation. 

Some messages issued on SYSLOG tell the operator when to execute EREP. 
For example: 

on 1W HARD WAIT CODE = D 

RUN EREP RECORDING SUCCESSFUL 

Other occasions when EREP should be executed are indicated in DOS/ VS 

Messages. 

For example: 

0T05E ERROR ON RECORDER FILE - RUN EREP 
Operator action: 
Schedule the EREP program to display the information on SYSREC. 

Either the operator action listed under the appropriate message will indicate 
the EREP option to select, or your IBM customer engineer will advise you on the 
option to select. 

Flowcharts in Sections 3 and 4 also indicate when to execute EREP. 
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SEREP (Stand-alone EREP) 

This is a stand-alone program that edits and prints hardware failure data either 
stored in the logout area of real storage or, for the Model 158, recorded on the log 
recording console file. 

SEREP provides a means of printing system status information stored in the real 
storage logout areas at the time of the machine malfunction. The SEREP 
printout is analyzed by your IBM customer engineer. 

For the Models 135, 145, and 155-1 1, SEREP is initiated using the standard IPL 
procedure. The SEREP program consists of a card deck and must be executed 
when the message issued on SYSLOG indicates "RUN SEREP." 
For example: 

0T1 1W HARD WAIT CODE = H 

RUN SEREP RECORDING UNSUCCESSFUL 

For the model 158 SEREP is contained on the Log Recording Console File which 
is loaded by using the Service and Index frames. 

If a hard wait condition occurs and no message is printed, a wait message in low 
address storage will inform the operator if SEREP is to be initiated. 

Flowcharts in Sections 2 and 3 indicate how and when to use SEREP. 
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Log Analysis Displays (Models 115 and 125) 

This aid, provided for IBM CE use, enables the condition of the internal hardware 
to be displayed, and, if required for offline analysis, to be printed on the 5213 
printer, if attached. On advice from the CE, an operator is able to obtain "hard 
copies" of the displays if a hardware error is the cause of a system malfunction. 

Maintenance (M) 

When the mode selection display is on the video screen and the operator enters 

selector character 'M' against 'Mode Specification,' the screen displays the 

maintenance repertoire. This repertoire consists of log analysis, micro tests, and 

CE manual operations, as shown in the figure below. The cursor is positioned next 

to the preselected 'M' so that any one of the maintenance modes can be 

selected. 
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MAINTENANCE PROGRAM SELECTION 



LL 


Ci 


TE 


STS 


CE-MAN.CPS 


A 


= LOG GENERAL 


J = 


= CPU 


S = lOP 


B = 


= CPU 


K = 


= 1403 


U = CRT-SCOPE 


C 


= CARD/PRINT I/O 


L = 


= 2560/5425 


V = l/OEXERS 


D 


= DISK 


M = 


= 3504/3525 


X = IPU 


E - 


= ICA 


N = 


= DISK 


Y = MATRIX S 


1 = 


= CHANG. DISKETTE 


= 


= ICA 


Z = MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 




I o oo QQ a c oo r 
noQoaoQO 



Note: E = ICA is displayed only when the system supports the Integrated 
Communications Adapter 

Figure 1-6. Model 125 maintenance program selection display. 

On the Model 115 the entry M = 3540/3525 and entry K = 3203/5203 

Log Analysis (A-E) 

When a parameter 'A' through 'E' is entered into the maintenance display, log 
information is brought to the screen. Entering 'A' for instance, causes a display of 
general log information that informs the operator if any logging occurred, and if 
so, which part of the system caused it. From this report, the operator can select 
a detailed log by keying in one of the four characters 'B' through 'E'. For example, 
'B' provides log information for the CPU. 

A "hard copy" printout of the displayed information can be obtained and saved 
for your IBM customer engineer by pressing the copy key, if a 5213 matrix printer 
is attached to your system. 

Further details are given in Section 2, F-5. 
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Display Frames (Model 158 only) 

A serviceability aid provided on the Model 158 allows the operator to display and 
obtain "hard copies" (on the 3213 printer) of the condition of the hardware. 

The information displayed or printed is used by the IBM CE to diagnose the cause 
of a permanent hardware error. A hardware error of this type will be recognised 
by the operator by an error message displayed on the program frame, for example 
the words STOR CHECK displayed in the lower right corner of the frames. 

Having recognized the existence of a hardware error, the operator can either inform 
the IBM CE immediately, or can "look at the hardware" by scanning the information 
on the display frames and obtaining a "hard copy" of them if desired. 

The type of information displayed is listed under numbers 6 to 26 in the INDEX 
frame shown below. 



21-CPU CHECKS&RETRY 



3--C0NFIGURATION 



23-CHANNELCHECKS1 
24-CHANNEL CHECKS2 



7-CTRL STORE DISPLAY 
8-COMIVlON CH DISPLAY 
9-CHANNELO DISPLAY 
10-CHAI\INEL 1 DISPLAY 
n-CHANNEL 2 DISPLAY 
12-CHANIMEL 3 DISPLAY 
13-CHANNEL 4 DISPLAY 
14~CHANNEL5 DISPLAY 
15-SCU DATA FLOWI 
16-SCU DATA FLOW2 
17-CHANNEL TO CHANNEL 
18-EXECUTION ARRAY 



20-CSBAR BKUPS 



28-EXTERNAL DIAGNOSTICS 






COMPOSE- "START "STOP "CLEAR 



Figure 1-7. The Model 158 Index Frame 

This frame is obtained via the manual and service frames. With this additional information 
about the hardware, the IBM CE will be able to advise on further system operation. 
How to use this serviceability aid is described in Section 2-F. 
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If the error cannot be isolated by analyzing the information obtained from the 
procedures already mentioned, other programs and tools must be employed during 
program reruns. 



Trace routines 

The trace routines supphed by IBM are special programs that "look inside" the 
central processing unit during system operation. 

Traces of program execution are especially valuable on the larger multiprogramming 
systems. 

Traces can indicate the phases used, the supervisor calls required, the types of 
interrupts encountered, and the I/O activity during program execution. Trace 
routines can also indicate paging activity and successful branching, and produce a 
printout of instructions fetched, and storage and general register alterations, 
during program execution. 



Supervisor communication macros 

Certain DOS/VS macros can be v^ritten into programs to provide more information 
about the state of the system at the time of an error. One such macro is PDUMP, 
which will give a dump of any specified real or virtual address area. 



Operator's console 

A useful tool for hands-on debugging is the operator's console. This is used for 
"tracing a loop" and displaying or altering registers and small areas of storage. 



Library and Service programs 

DOS/VS Hbrary and service programs are useful when information is required 
about previously written programs that are used by problem programs. These 
DOS/VS programs will Hst volume directories, print listings of the programs 
contained in the libraries, and display file label information. Such information 
is required, for instance if a particular phase on a private core image library causes 
incorrect results of calculations when used by one of the tested problem programs. 



VSAM Programming Aids 

VSAM (Virtual Storage Access Method) provides aids that print, Hst, and 
verify data recorded on VSAM files. Assembler macro instructions for VSAM 
are also provided to allow the programmer to obtain information about I/O 
operations (OPEN, GET, PUT, CLOSE) during execution of VSAM programs. 
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The analysis to be made depends on when the job failed and how much pertinent 
information the operator obtained from the system at the time of failure. It also 
depends a great deal on the system environment. The first step is to examine 
messages printed on the console log sheet, and to look for any messages on the 
output printer. 

The next step is to examine any other printed output, for instance, program output 
and storage dumps. 

For a successful analysis, the programmer, who should be familiar with the 
program, will require: 

• The program listings 

• The linkage editor map 

• Flowcharts of the failing program. 

In the more difficult cases of program errors, the programmer will also require: 

• The supervisor listing 

• Output of the trace routines 

• Dumps of the data input files 

• The input media 

• Listings (or displays) of file label information 

• Listings (or displays) of the libraries. 

If the program failure was caused by a hard wait, the programmer should scan the 
EREP printout (if one was obtained) to eliminate any possibihty of a hardware 
failure, and examine the stand-alone dump. 

Section 4 describes in detail how to use the above listed output during offline 
debugging. 
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2.1 



Section 2 

SERVICEABILITY AIDS 



How to use this section. 

Familiarize yourself with the contents of this section, which gives details about 
the operation and execution of the serviceabiHty aids offered by IBM. 

The reference chart shown on the opposite page lists the aids described in this 
section in groups according to type. 

All right-hand pages in this section have running-tabs numbered to correspond to 
this chart. The chart helps you to locate details about any aid described in this 
section. 

For example: 

SEREP is described on page marked F - 4 

Another example: 

When a dump of the low address storage is required in an operators flowchart of 

Section 2 and 3 it is indicated as: 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1 -F for Models 1 35, 145, 1 55-1 1 
and D-2-F for Models 1 1 5, 1 25 
and D-3-Ffor Model 158 



D-I-F, D-2-F and D-3-F refer to tab numbers that identify unique pages in this 
section. 

In this example it guides the operator to the flowchart procedure for dumping 
low address storage. 



Table referencing in this Section 

Illustrations in this Section do not have figure numbers, but are referenced by the 

text. For example, "the next illustration shows " or "the figure on the 

opposite page shows the ". 

However, because tables in this section are often referenced from other parts 
of this manual the tab referencing system is used for the Tables. For example: 
A table in sub-section B-6 is given the reference of B-6. If there is more than 
one table in any sub -section the first table is given the reference B-6-A and the 
second table B-6-B, and so on. 
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Dumps of, and 


changes to the 


real and virtual 


address areas 


1 


Operator 




commands 




ALTER 




DISPLAY 




DUMP 


2 


System 




dump 


3 


DUMPGEN 




and the stand- 




alone dump 




program 


4 


Transient dump 


5 


Supervisor 



communication 
macros 



VISUAL INDEX 




10 



11 



Library display 
programs and 
utilities 



PARTI PDAIDS 
Introduction, 
system 

requirements, and 
terminating 

PDAIDS 
Description, 
operation, and 
examples 

The PD area 



Initializing 
PDAIDS 



PDAID 
Job stream 
examples. 
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SDAIDS 
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SDAIDS 
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LSERV 
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programs 



ESERV 



VTOC 

display program 



Reserved for 
future use 
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dump Utility 



Initializing 
SDAIDS 



Examples of 
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Hardware aids 
through the 
operator's 
console 




10 



11 



i 1 



ALTER/DISPLAY 
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and 155-11 



ALTER/DISPLAY 
Models 1 15 and 
125 



ALTER/DISPLAY 
Model 158 



Instruction 
stepping 

Models 135, 145 
and 155-11 



Instruction 
stepping 
Models 11 5 and 
125 

Instruction 
stepping 
Model 158 



Stop on address 
Models 135, 145 
and 155-11 

Stop on address 
Models 115 and 
125 



Stop on address 
Model 1 58 

Models 115 and 125 
Console dump 
operation 

Store status and 
clear real storage 
(all Models), and 
Save Usage Counters 
(Models 115 and 125 
only) 



Job control 
commands and 
statements 



Low address 
storage 



Wait state 
messages 



Linkage Editor 
Map 



Hardware error 
recovery and 
recording 



Recovery 
Management 
Support 
(A general 
description) 

Recovery 
Management 
Support 
(A detailed 
description) 

EREP 



SEREP 



Maintenance 
Log Analysis 
Models 115 
and 125 

Display frames 
(Model 158 only) 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(ALTER) 



The ALTER Command 

To activate the ALTER command press the REQUEST key and enter ALTER. The 
command is used to alter from 1 to 16 bytes of virtual storage starting at the 
specified address. 



c 



Operation 


Operand 


ALTER 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command has been entered and the END key pressed, the hexadecimal 
representation of the information to be placed in storage should be entered. Two 
hexadecimal characters (0 to F) must be entered for each byte to be changed. 
If an odd number of characters is entered, the last character is ignored and its 
associated byte is unaltered. 

Examples are shov^^n below. 







■ 




HHIHH 






• 


AR 


:I.I60A READY FOR COMMUNICATIONS „ 








AR 


alter 040B20 










AR 


00622000 








• 


AR 


alter 000430 








AR 


:I.I42D ADDRESS WITHIN SUF'ERVISOR OR SVA 










AR 










• 


AR 


IIAOA READY FOR COMMUNICATIONS. 








AR 


alter 0404 eO 










AR 


88800004 








• 


AR 




fniHT 












B^^HIH 
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Dumps of, and changes to Real and Virtual Address Areas 



Restrictions 



1. If the bytes to be altered cross the boundary from a vahd to an invaHd address 
space (see the third restriction, below), only the bytes in the valid address 
space are changed, and the following message is issued on SYSLOG: 

11471 XX BYTES COULD ONLY BE ALTERED 



OPERATOR COMMANDS 
(ALTER) 



U 



2. If the highest available virtual storage address is exceeded before sixteen 
bytes are printed, the command is terminated and no alteration can occur. 



3. If the specified address is within an invahd address space, message 

1I41D INVALID ADDRESS 

is issued on SYSLOG. 

An INVALID ADDRESS is one of the following: 

• The address of a location in the gap between real and virtual 
address areas. 

• The address of a location beyond the end of virtual storage. 

• The address of a location in the page pool. 

• The address of a location in a virtual partition whose real partition 
contains a program running in real mode. 

4. Altering the Supervisor area or SVA 

If the address entered falls within the supervisor area or within the shared virtual 
area (SVA), a warning message is issued on SYSLOG: 

1I42D ADDRESS WITHIN SUPERVISOR OR SVA 

To respond to this message, press END/ENTER to terminate the ALTER 
command or reply with IGNORE to allow alteration. 

When to use 

This aid is primarily a hands-on debugging aid. The programmer can use it in 
conjunction with program listings to modify any part of the programs presently 
running in virtual storage. This enables immediate checks on results of 
program changes during execution of the program. 
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OPERATOR COMMANDS 
(DSPLY) 



The DISPLAY Command 

To activate the DSPLY command press the REQUEST key and enter DSPLY. The 
command allows the operator to display on the console printer keyboard 16 bytes 
of virtual storage starting at the specified hexadecimal address. Two hexadecimal 
characters (0 to F) are printed for each byte of information; these characters 
represent the hexadecimal equivalent of the current information in the virtual 
storage. 



Operation 


Operand 


DSPLY 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command is entered and the END/ENTER key is pressed, the hexadecimal 
representation (two characters for each byte) of sixteen bytes of virtual storage 
will be printed. 

Examples are shown below. 




c 
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Dumps of, and changes to Real and Virtual Address Areas 
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^y 



Restrictions 



1. If the sixteen bytes cross the boundary from a vahd to an invalid address space 
(see the third restriction, below) only the bytes in the vahd address space are 
displayed, and the following message is issued on SYSLOG: 

11481 XXBYTESCOULDONLYBE DISPLAYED 

2. If the highest available virtual storage address is exceeded before sixteen bytes 
are printed, the command is terminated. However, the contents of those 
bytes that fall within the virtual address area are printed. 

3. If the specified address is within an invalid address space the following message 
is issued on SYSLOG: 

1I41D INVALID ADDRESS 

The definition of invalid address space is listed under item three of "Restrictions" 
in the description of the ALTER command. 

Wtien to use 

This aid can be used during hands-on debugging, or an operator can be 
instructed to use it at specific addresses in a program. 

For instance, loop count areas, small areas modified by loops, or parts of I/O 
areas can be dumped or displayed during program execution. The dump 
information will help during offline program debugging. 
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OPERATOR COMMANDS 
(DUMP) 



The DUMP Command 

To activate the DUMP command press the REQUEST key and enter DUMP. The 

command allows the operator to display large areas of virtual storage on SYSLST. 

The SYSLST used may be assigned to any partition, but it must be a printer and it 

should not be in use by the partition. If the same printer is being used by the 

partition, the printed output will be a mbcture of dump and partition output. 

If SYSLIST is assigned to a 32 11 printer and the printer's indexing feature 

is being used, a certain number of characters may get lost on each line of 

the dump. To avoid this, the operator should load a new FCB (forms control buffer) 

image to disable the indexing feature before he issues the DUMP command. 

The new FCB image can be loaded either by issuing an LFCB command 

or by executing the SYSBUFLD program. 






Operation 


Operand 




-1 


r -r 1 


DUMP 




S 
BG 


(BG) 
(Fna') 


* Note 1 






Fn 








BGS 








FnS 








PDAREA 








xxxxxx, xxxxxx 













n,n' = 1,2,3,4 



Note: 



If the first operand is omitted, the general registers, control registers, and all 
storage that is currently used by programs, except that used by the supervisor 
(unless the operand BGS or FnS is specified), will be dumped. See note 2. The 
storage used consists of: 

1. Real storage not belonging to the page-pool 

2. The virtual partitions in which a program is currently running. 






Description of the operands: 



Operand 


Meaning 


S 


Causes a dump of storage used and the supervisor area. See note 2 


TbgI 

Fn 


Causes a dump of the specified partition and its associated registers. 
If a real-mode program is running in the specified partition, the temporary 
real partition is dumped. If a virtual-mode program is executed in the 
specified partition, the whole virtual partition is dumped. 




~BGS| 
FnsJ 


Causes a dump of the same areas as described for the BG/Fn operand. 
However, the dump will include the supervisor area. 


PDAREA 


The PD area and the registers will be dumped (See Section 2, B-3 for 
details and a description of the PD area.) 


XXXXXX, 
XXXXXX 


Specifies the starting and ending address of virtual storage, with 
associated registers, that is to be printed. If the starting address is not on 
a f ullword boundary, the address is rounded down to the first fullword 
boundary; if the ending address is not on a fullword boundary, the 
address is rounded up to the first fullword boundary. A minimum of one 
fullword is dumped, beginning at the start address. 



BG 
F1 
F2 
F3 
F4 



Note 1: 

^ When any of these additional operands are specified, the area of virtual storage 
specified by the first operand is dumped on the SYSLST assigned to the partition 
specified by this operand. SYSLST must be a printer and should not be in use by its 
assigned partition. If the same printer is being used by the partition, the printed output 
will be a mixture of dump and partition output. 

^ (If this operand is not specified, the SYSLST printer assigned to BG is used. See note 2.) 



>< 
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When to use 



o 



This command is useful in circumstances similar to those described for the 
DSPLY command: to obtain information about I/O areas, or areas modified by 
loops or transients during program execution. The only difference between this 
command and DSPLY is in the size of the area that can be dumped. 

Note: Logical transient routines can not be checked because the LTA is used by 
the DUMP transient. The information in the LTA is therefore overwritten by 
the DUMP rou tine. 

An example is shown below of a dump of the PD area using the DUMP command, 
when SYSLST is assigned to a hne printer. 



OPERATOR COMMANDS 
(DUMP) 







Ho 


CR 0-7 
( C* 8-F 

PO»RF» 

' 009*80 

009440 
1 009'»C0 
' 009*60 

009 500 
1 009 520 
' 009 540 

009 550 
k 0U580 
' 0095A0 

0095CO 
1 0095EO 
' 009600 

009620 
1 009640 
' 009650 

009580 
1 0095A0 
' 009 5C0 

0095E0 
1 009700 
' 009720 

009740 
1 009760 
' 009780 

009 7A0 
k 009 7C0 
' 009 7E0 

009800 
1 009820 
' 009 840 

009860 
k 009880 
' 0098AO 

009 8C0 
1 0098E0 
' 009900 

009920 
k 009940 
' 009 960 

009980 
1 0099A0 
' 009 9C0 

0099E0 


804000EO 
00005 300 

E3D37EF3 
00000000 
FFFFFFFF 
FFFFF=80 
50C091C4 
47F09384 
00004111 
58B10020 
800347=0 
078A070A 
078A3501 
91BS07=A 
001842A3 
47F09110 
00009566 
8AF3D300 
8AF00000 
20000000 
00OE070C 
04000000 
00008A=0 
FF008AFO 
070=2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
OOO6O70F 
04000000 
00000000 
00000952 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08003000 
00000000 
00000952 
070:2 000 
00005240 
8AF00800 
8AF0O0OO 


OOOOF600 
00000000 

F8F07000 
00004798 
FFFFFFFF 
800047AE 
58A00014 
95FFA002 
000058CO 
19AB4740 
910CBFB7 
49209038 
600691C8 
58B091B8 
00029430 
SSAlOOi: 
000099FC 
OOOOOOOE 
00000400 
09620000 
20000000 
E 2400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF 00800 
8AF 00000 
20000000 
0OOE070C 
04000000 
00008AF0 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09520000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 


FFFFFFFF 
00000000 

000099FF 
O0OO3AA4 
FFFFFFFF 
47F0915C 
48A0A040 
4783910C 
91C49120 
90FE41CB 
B0454770 
078A070A 
07eA58B0 
44009058 
B002912 
50AB000S 
C4E4D400 
070F2000 
OOOOOOOE 
000004 00 
09520000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
000004 00 
09520000 
20000000 
E2400000 
08000000 
00000000 
0000095 2 
070C2000 
0000E240 
8AF00800 
8AF00000 
20000000 
OOOE070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 


FFFFFFFF 
00030300 

0000479C 
00031330 
3FDEFFFF 
58B091B8 
492AOOO0 
1BCC43CA 
100647EO 
004819AC 
90D:D7D2 
4920903A 
91B841BB 
50280302 
10054710 
9133B332 
30002330 
30300952 
070C2000 
3000E240 
8AF00BQ0 
8AF30300 
20000300 
000E070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09520330 
OOOEFFOO 
OO0E070F 
04000000 
00000000 
00000952 
OOOOOOOE 
0OO3030E 
00000400 
09620000 
20000300 
E2400000 
08000300 
00000300 
00000962 
070C2000 


00000000 
00300000 

30301S3E 

07:4ci:9 

FFFFFFFF 
D20FB002 
4780909C 
033239:o 
910C50C0 
472090FE 
B33BB33B 
078A58B0 
001259B0 
501B0006 
919C9130 
47809192 
D5E7FFFF 
30300030 
00000962 
OOOOOODE 
OOOOOOOE 
00300400 
09620000 
20000000 
E2400030 
08000 000 
00000030 
00000952 
070C2030 
0000E240 
8AF00800 
8AF00000 
20303000 
000E070C 
04000000 
30308AF0 
FF008AF0 
070F2030 
OOOOOOOE 
00000400 
09520000 
300EFF3O 
D00E070F 
04303000 
00000000 
00000952 


00000000 
00000000 

0000B44E 
C4C9E3E5 
FFFFFFFF 
00380201 
95FFA000 
000358A3 
91C41BAA 
1BAB5AAB 
58C091C4 
008058BO 
91BC4743 
D201B000 
80024773 
47F090CA 
000EO7OC 
04000003 
00008AF0 
FF008AF0 
O70F2OO0 
OOOOOOOE 
00000400 
09520000 
OOOEFFOO 
0OOEO7OF 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF00800 
8AF00003 
20000000 
000E070C 
04000000 
00008AF0 


00003000 
C23O0OOO 

00000C55 
FFFF0009 
FFFFFFFF 
BOOOOOBA 
4780910C 
00805 ACO 
BFA73041 
003C58B0 
58409O5C 
B01CJ50? 
915558B3 
91B050A0 
91100702 
E2400000 
20000000 
E2400000 
08000000 
30003000 
00000962 
070C2000 
OOOOE240 
8AF00800 
8AFO0OO0 
20000000 
0O0E37OC 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00003400 
09520000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000952 
OOOOOOOE 
OOOOOOOE 
00000400 
09520000 
20000000 
E2400000 
08000000 


OOOOOOOO 
00000200 

00009F02 
FFFFFFFF 
FFFFFFFF 
50A0905: 
41AA0008 
A024581; 
47809110 
91B88EA7 
49239035 
B00391C0 
91B4 5OB0 
905C88A0 
BOOB BOOB 
00009554 
09620000 
OOOEFFOO 
O0OEO70F 
04000000 
OOOOOOOO 
OC00 0952 
OOOOOOOE 
OOOOOOOE 
0000 0400 
0962 0000 
20000000 
E2400000 
08000000 
OOOOOOOO 
00000952 
070:2000 
OOOOE240 
8AF0O8OO 
8AF0OOOO 
20000000 
OOOE070C 
04000000 
OOO08AFO 
FFO08AFO 
070F2000 
OOOOOOOE 
00000400 
09520000 
OOOEFFOO 
OOOOOOOO 
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K K #..* 






.........3...... 


..#..0.......... 














..N. ...H. ....... 












.0.. ....#. ...... 


.....0..S ...... 


OUM 

.0 


NX 















....S 0. . 











S 


S 




s ,'. 










.......0........ 


.0 














s .... 




...0 








......S .......0 






.......... ..s .. 








..S 0.... 

.0 










^^^^^^(^^^^ 



The example below shows the beginning of a dump of the BG partition using 
the command DUMP BG when SYSLST is assigned to a line printer. 
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SYSTEM DUMP // OPTION DUMP statement 



If this statement is included in the job stream a dump of the partition, the supervisor 
and/or the SVA will be printed on SYSLST, whenever a program is canceled either 
by the operator or by other cancel conditions. The dump includes a printout of 
the supervisor area, and if the program check is within the SVA, a dump of the 
SVA or parts of it. For this reason the dump is often referred to as a SYSTEM 
DUMP. 

Note: There is no need to insert the // OPTION DUMP statement in a job stream 
if the default option of the DUMP parameter has been specified in the STDJC macro 
during system generation. If however the dump is not required when abnormal 
termination occurs during execution of a particular job, the I I OPTION NODUMP 
statement must be included in the job stream. 

To enable the // OPTION DUMP statement to operate, one of two types of system 
dumps must be cataloged into your system during system generation: 

• A standard system dump, whose printed output is in hexadecimal code 

• A translating system dump, whose output is printed in hexadecimal and 
alphameric codes. 

The dump output includes the following: 

• General registers 

• Floating point registers, if FP is specified for the system 

• Control registers 

• Active communication region address (See Section 4 for a description) 

• Supervisor (see note below) 

• PD area, if PD is specified for the system (see B-3 in this section for details) 

• Label length 

• Partition identifier: BG, F4, F3, F2, or Fl 

• Temporary real or virtual partition. 

• The Shared Virtual Area (See note 2 below). 

Note 1: The LTA (Logical Transient Area) is used to contain the dump program. 
Therefore, the LTA printed in the dump will always contain the B-transients 
^$BDMPBC (if the dump is directed to a line printed or tape unit) or $^BDMPDC 
(if the dump is directed to a disk). 

Note 2: If a program check occurs in the SVA before the dump logical transients 
are loaded and have control, a dump of the SVA is executed. Even if the program 
check occurs in a phase within the SVA, the phase name of which has been deleted 
from the SDL (System directory list) before the dump transients have control, parts 
of the SVA are dumped that contain the phase in which the program check 
occurred. 

When to use 

Insert this statement into job streams for new, modified, or untested programs. 
The partition dump and general register dump can be analyzed and the 
information obtained will help during offline program debugging, 



o 



w 



'K 
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Ho\N to use the dump output 



Dumps of, and changes to Real and Virtual Address Areas 

SYSTEM DUMP 



4f\ 



Begin the analysis by examining the error message issued on SYSLOG and/or on 
SYSLST. If the program check occured within the SVA, the message 

PART OF SVA WHICH CAUSES THE ERROR 

is printed after the dump of the partition in which the program is running, or if the 
entire program is running in the SVA, the message is printed after the dump of the 
program save area. A hexadecimal dump, including storage of the SVA, or a dump 
of the phase running in the SVA addresses in which the program check occurred — 
follows the message. 

The example below illustrates how to use the system dump in conjunction with 
program listings and the linkage editor map in order to isolate a data exception 
program check occurring in a program running in a BGV partition. 

Step 1 : Check for messages on SYSLOG and/or SYSLST. From the message obtain the address at which the 
interrupt occurred and reason for the program check. 





o 



Step 2: Locate the register values printed at the beginning of the system dump. Scan the contents of register 
for unreasonable values. (This may help in later problem analysis.) 




I f 
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SYSTEM DUMP 

Step 3: Locate the linkage editor map and obtain the relocation factor. Subtract this value from the address 
given in the program check message. 

In case of a program check in the SVA, the relocation factor appHcable is obtained as follows: 

1. Subtract the instruction address printed in the program check message from the first address 
printed in the dump of the SVA. 

2. Add the result to the start address printed in the assembly listing for the program or phase causing 
the error. 







Step 4: Locate the resulting address (from step 3) in the program Usting. This will give the failing instruction. 




Step 5: Compare the hexadecimal code for the instruction in the program Usting with the code in the dump. 
It should be the same. 



040646 CCAF5810 CDOA58F1 001045EF 000^024? 

040660 47F0B2C2 4780B302 95E0B985 4780B75C 

^ ntnftflp tcQnrtcc UFOOChOb 4E A0C60E 1A561A57 

, .ll^tS406A0 OOIOOSEF 95D7C83rTrr««ft4fci_5850CDB2 

ll/Ol 0406C0 58A0CDB2 D203C672 BBD2DE03 CF? 

.T 0406E0 CE105810 COAE58F1 001045EF 000CD203 

040700 D203C682 BB020203 C686BB02 D203C58A 

040720 C67EC5FC DE03C682 C604DE03 C686C60C 

040740 CE2qo202 B94DC677J320BB952_COEE0202_ 



10010 45EF00OC 

47F0B24C 4E50C5E6 4E60C5EE 4E70C5F6 

1A584E50 C6155810 CDAE4100 001B58F1 

5860CDB2 5870CDB2 5880CDB2 583 

D283B936 B935D203 B95U;6»e'TJ5l5B93B 

aBD2 D203C67A,^« g?D203 C67EBBD2 

BBD2 bE03 C676CSEC| DE03C67A C5F4DE03 

DE03C68A C614D283 B936B935 D212B93B 

B950C67B D210B962 CD9ED202 8972C67F 









^ 



Step 6: Locate the location in the program listing that defines the data area used by the failing instruction. Use the 
relocation factor from the linkage editor map to calculate the address of the data area in the dump. 




Step 7: Locate the data rea used by the instruction in the dump. Check if the data is specified for the failing 
instruction. If it is not, continue by identifying the point in the program listing at which the data 
is prepared. 



oec^ 



041600 
041620 



3>L 



0416A0 
0416C0 
0416E0 
041700 
041720 
041740 



E2E5C340 05C5E640 50000048 92201004 47F0301C 40404040 40404040 F3841078 SVC NEW G 0.. 3... 

00609240 1080DC07 10785000 F3841081 00649240 10890C07 10815000 9D004000 .-. ......G.3 C... . 

4770303C 9C 004000 9D00400Q 47303048 47F01010 40404040 40404040 40404040 .0.. 

00000000 00000<E?I 00000000 0000004C 00000000 OOOOOIOC 00000000 0000004C Z 

00000000 00000«C\00000000 0000068C OOOOOOOO 0000026C 8004033C 92601004 >/ /: — 

50000048 47FU3UH. E3n604hZ 4040FZF6 4^202/.^/, . / l\ .O..TOMS '""^^^T^^ . , / 

40202120 40202120 0306D5C4 D6D54040 40400{7>4<» ^ .^Ut«^ ¥ A^^ -^yiecA J ...LONDON Zw-A /v^ o»X'^«' 

17800000 84000COO 00040004 17800004 17880^ f '' if ^ 'Z^ ^«>*^ '^ /** C^Oi^ . 

090417A4 60000020 090417C4 6000002F 090417F3 6000001F 09041812 60000021 . . . .- P- j-,... £x/lf{ 
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DUMPGEN 



The IBM program DUMPGEN allows you to generate a stand-alone dump program 
that must be used to obtain information about the system under certain conditions 
of system malfunction. 

The dump consists of a printout of real storage (except bytes X'OO'— X'17', X'40'— 
X'4B', X'BA'-X'BB' and 214 bytes of a non-critical area in the supervisor). Two 
types of dump programs can be generated using DUMPGEN: 

• Translating dump 

• Formatting dump. 

Both programs produce a conventional dump with translation. In addition, the 
formatting dump produces a pre-formatted printout of the DOS/VS interface 
tables. This dump is generated if the DUMPGEN option FORMAT=YES is 
specified. 



DUMPGEN AND 

STAND-ALONE 

DUMP 



o 



Executing DUMPGEN 

Before being able to execute DUMPGEN you must catalog it to the core image 
library. Execute it in any partition by the job control statement or command: 

// EXEC DUMPGEN 

You enter DUMPGEN and read its control statements from SYSIPT. 

Note that SDAIDS may not be initiated during execution of DUMPGEN. 
(SDAIDS are described in Section 2-B.) The two types of control statements used 
with DUMPGEN are ASSGN and OPTN, described as follows: 

ASSGN Statement: ASSGN defines the output device for the stand-alone 
dump program. 



Name 


Operation 


Operand 


(blank) 


ASSGN 


SYSLST, X 'cuu' 




o 



SYSLST The only valid logical unit assignment. 

X 'CUU' Must define the address of the SYSLST printer. If the ASSGN 
statement is omitted, thenX'OOE' is assumed. 



7 .,-, rn 



O"^ 



f ' 



<L^ 



O 



A I 






oo 



■"x 



n 

h'^'- 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



OPTN statement: OPTN defines the type of output generated by the DUMPGEN 
program. 



Name 


Operation 


Operand 


(blank) 


OPTN 


INTR= NO ^ '^'^ ' 
Y5&S 

DECKS= nnnnnn Js'^^ 
PPOOL= H0'-^'\^^ 

FORMAT= -ft© 

YES -^ 

/TAPEipt=— .rvlO./ 
YES 



Operands for the DUMPGEN option statement. 

INTR YES produces a DUMP program that, when loaded, enters the WAIT 

state. Either press the INTERRUPT button on the CPU operating 
panel to print the output on X'OOE', or press the STOP button and 
then START button of the printer desired for the output device. 
NO produces a DUMP program that, when loaded, prints out the 
contents of real storage either on the SYSLST printer defined with 
the ASSGN statement or on X'OOE'. 

DECKS Specifies the number of DUMP card decks (punched out on SYSPCH) 
desired, nnnnnn may be any decimal number from 1 to 99,999,999. 
/ A blank card separates each deck produced. If DECKS is omitted, one 
deck is produced. 

PPOOL YES produces a dump program that, after printing out real storage, 
will print the formatted contents of the Boundary Box and the 
contents of the real storage in sequence of ascending virtual addresses. 
If NO is specified, the last two items are not printed. 

FORMAT YES produces a translating stand-alone dump that formats and displays 
the DOS/VS supervisor tables after displaying the contents of real 
storage. This formatted display depends upon the location of the 
communications region. 

If the communications region cannot be related, the program is 
terminated when the formatted display is to occur. 
In this case the following message is printed on the dump output: 

COULD NOT FIND COMREG BETWEEN CO AND AOO, 
FORMATTING WILL NOT OCCUR 

If NO is specified or FORMAT is omitted, a non-formatting translating 
dump is generated. 

TAPEIPL If YES is specified and SYSPCH is assigned to a tape unit, the stand- 
alone dump written on tape may be IPLed directly from the tape unit. 
If NO is specified, or TAPEIPL is omitted and SYSPCH is assigned to 
a tape unit, the stand-alone dump records are written on tape preceded 
by an ASA control character. 
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Control statements for the DUMPGEN operands 

Control statements may be specified in any order; however, the following rules 
apply: 

• All statements may be omitted, but if they are, DUMPGEN assigns printer 
X'OOE', INTR=NO, FORMAT=NO, and PPOOL=NO options. 

• Only one operation and only one operand per control statement is allowed. 

• The last statement processed of a duphcate operation overrides all previous 
statements of the same operation with similar operands (if DECKS=2 is 
followed by DECKS=5, five decks are punched). 

• The name field must be blank. 

• Decimal operands may contain leading zeros. 

• One of more blanks must follow the operand if comments are to be made. 



DUMPGEN AND 

STAND-ALONE 

DUMP 






Job stream example 

The following example is a typical job used to create a stand-alone dump. 



//lOB 

// EXEC DUMPGEN 

Col. 2 

ASSGN SYSLST, X'OO^.' 
OPTN FORMAT=YES 
■^.OPTNPPOOL=YES-'- ^-'^ p ,. :< s ^ '^■' 

_OPTNDECKS=f X ' 

/& 

Note: If a 3221 is the only printer in your installation, the indexing feature 
should be used with great care; shifting the print Une to the left 
or too far to the right causes loss of a certain number of characters 
on each line of the dump. 



y 
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DUMPGEN messages 

The functions of DUMPGEN-to-operator error message routines are: 

• Cancel the job if SYSLOG is not a 3215/3210 or a System/370 Model 125/1 15 
video display unit. 

• Reissue the message if operator response is to press the CANCEL key 

• Process an operator response of END/ENTER as IGNORE 

• Cancel the job if operator response is CANCEL. 

• Ignore the control card in question when the operator response is IGNORE. 

If none of the preceding operator responses is issued, then DUMPGEN assumes 
that a correction has been made and processes it. 
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/f ~^ 

DUMPGEN AND Stand-alone Dump Program \j/ 

STAND-ALONE 

DUMP This program is generated for your installation using the IBM program DUMPGEN. 

DUMPGEN produces a dump program that is either punched into a card deck or 
stored on magnetic tape. When required, the dump program thus generated can be 
loaded into the system via the standard IPL procedure. 

The stand-alone dump program that is generated by DUMPGEN provides either 
a conventional dump or a formatted dump, depending on the FORMAT option 
used in the DUMPGEN program. 

Operation 

During execution of the stand-alone dump program, a non-critical area in the 
supervisor is used to load the program. The LOAD ADDRESS of the non-critical 
area is punched (in decimal) in the first card of the stand-alone dump card deck 
punched by the DUMPGEN program. Because of this use of the non-critical 
area it is recommended to use the stand-alone program for a system using a 
supervisor that was used for the generation of that dump. 

The conventional dump prints the contents of real storage locations, but does not 
dump the floating point registers. In addition to the areas dumped by the conven- 
tional dump, the formatted dump prints the DOS/VS interface tables in a more 
readable form. 

For both types of dump the following is printed: 

1. The contents of the general registers, the old and new PSWs, the interruption 
codes, CSW, CAW, and TIMER. i 

2. The contents of real storage in 2k blocks. Each block is preceded by a V„.> 
sequence number. 

3. At the end of the real storage dump, page address and status information is 
printed that contains the following information for each page frame: 

• The virtual address 

• The real address of the associated page 

• The sequence number of the 2k block 

• Information that indicates whether the contents of the page frames 
has been changed. 

4. The contents of the control registers are printed after page address and 
status information. 

5. Depending on the options selected, the following then occurs: 

IfPPOOL=YES 

• The formatted contents of the boundary box is printed after the 
control registers. 

• The contents of real storage is printed in 2k blocks in sequence of 
ascending virtual addresses. 



'L^' 
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If FORMAT=YES, DUMPGEN AND 

the formatted contents of the tables hsted below are printed at the end STAND-ALONE 

of the dump. DUMP 

COM REGS 

PIBs 

AP SUBTASK PIBs (if AP supported) 

PARTITION SAVE AREAS 

LUBs 

PCIL LUBs (if PCIL supported) 

PUB 

ERROR RECOVERY BLOCK 

CHANNEL QUEUE 

FLOATING POINT REGISTERS 

COPIED AND TRANSLATED CCB 

FIXINF EXT. BLOCKS 

COPIED AND TRANSLATED CHANNEL PROGRAM 

IDAL BLOCK QUEUE 

FIXINF BLOCK 

BOUNDARY BOX 

SEGMENT TABLE 

PAGE TABLE 

PAGE FRAME TABLE and PAGE FRAME TABLE EXT 

SELECTION POOL 

The full names of these tables, their contents, locations, and meaning to 
the system programmer during offline program debugging are found in 
Section 4. 

An example of the formatted output of these tables is given in Appendix G. 

The two following illustrations show the information that is printed 
after executing the dump program. 

When to use 

The stand-alone dump program must be used whenever the severity of a 
system malfunction, such as a loop or hard wait state, prevents alternative 
methods of obtaining system information that aids offline debugging. 

Flowcharts in Section 3 indicate when to execute the stand-alone dump 
program. 
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DUMPGEN AND 
STAND-ALONE 
DUMP 



□ • 



C3 



i.^D 




16 General Registers 

Low address storage 
(Formatted). 



Last 2k block of 

real storage. (Without translation. 



First 2k block of real storage 
beginning at byte 0. (With translation). 



2k blocks of real storage, (With translation) 



Last but one 2k block of real 
storage, (With translation). 



Page address and status information 



16 Control Registers. 



The contents of tables and areas 

as listed in the previous text are printed 

(See appendix G for an 

example of formatted output of these ai-eas). 



PSWS 
EXT OLD 
EXT NEW 
EXT INT 
SVC OLD 
SVC NEW 
SVC INT 
PGM OLD 
PGM NEW 
PGM INT 
MCKOLD 
MCK NEW 
MCK INT 
I/O OLD 
I/O NEW 
I/O INT 
CSW 
CAW 
TIMER 






} 



FORMAT=YES 



A pictorial representation of the stand-alone dump and formatted 
printout, generated using DUMPGEN options FORMAT=YES 
and PPOOL=NO. 



>/ 
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''"-""-'.and Changes to Rea,aw 



'^ General Reg,-,^3^^ 

Low address storage 
'formatted). 



'^^ 2k block of 
'■"^' borage. (vv;,h„ 



"ftransiatfon.) 



^:!5^^'-^ofrea, 



■"^'tfifans/at/onJ 



2k blocks of 



real 



^^°^^9e,fw/thtrans,at/ 



on;. 



L^st but one PI. *,, 






ion 



^OLlAIDARVeo^ 



2k blocks Of real 

'" ascending 
sequence of 

^'Jtua, addresses. 



PPOOl=Yes 



A P/ctoria; represent • 

' ~'V0, and 



PSWS 
EXT OLD 

EXT IMT 

SVC OLD 

SVc MEW 

SVC /Mt 

PGM OLD 

PG/M ;/vr 

MCK Old 

'^CK NEW 

'/O OLD 
'/O A/EIA/ 
'/O »Mr 
CSI/V 
CAW 

t/Mer 




*™-ceabitoj,^,.^^^ 
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DUMPGENAND A note to the operators 

STAND-ALONE 

DUMP Before the stand-alone dump program is executed, the operator must dump, or 

display and note, the contents of bytes X'OO' through X'17', X'40' through 'x'4B', 
X'BA', and X'BB' of low address storage. (The contents of these bytes will be 
destroyed when the dump program is loaded.) It may be important to the pro- 
grammer to have a note of the contents of the control registers at the time of the 
error. This can be done by (1) executing the store status function or (2) dumping 
or displaying the control registers using the ALTER/DISPLAY feature described 
in Section 2-D, The operator should also display and note the current PSW before 
executing the dump. Also there may be a need to dump the page data set after 
executing the stand-alone dump. For example, the programmer may have made a 
request for a "SYSVIS dump" after the execution of a stand-alone dump. The 
flowchart shown opposite indicates the procedure for loading and executing the 
stand-alone program. 

A note to the programmers 

To ease the task of locating and interpreting the contents of control blocks and 
tables during offline debugging, generate the formatted dump program 
(FORMAT=YES). 

A note to IBM SE/CE 

For any System/370 supporting RAS the serial number and System/370 Model 
type is stored in the first 8 bytes of the RAS Unkage area, the address of which 
is located at displacement X'70' of SYSCOM. 

How to use 

Initially the following Hsted areas should be examined, for what appears to be 
unexpected information. 



^' 



1 . General registers. "let 4 ) 

2. Current PSW and old PSWs. J ^^^'^^^^^ ^-^ 

3. From the PIB table locate the partition in control at the time of the error. 

4. Registers and the PSW in the partition save area. 

5. Using the program listing of the program that was running in the failing 
partition, scan the I/O areas, instructions, intermediate results, and 
operands in areas you consider critical to the program. 

6. Use the linkage editor map to locate where the system should load the 
phases. 

7. For further analysis, check the PUB table for any I/O request left out- 
standing, and, depending on the type of the program in error, check the 
CCB/DTF table and label save areas. 

The order in which these areas are examined rests with you, who as programrner, 
will know what the program was expected to do, and approximately what the 
contents of certain registers and I/O areas should contain. 

An example of a stand-alone output is given in appendix G. 

By examining the dump in this way and by consulting the program Hsting you 
will be able to form an idea of the cause of the error, and to discover where to 
look for further clues or pointers. 

However, the first pointer will depend on the symptoms of the error, the 
environment, what the program was expected to do, any output that became 
available, and incorrect results of calculations. 

Note: Use the information printed at the start of the dump, that is before the print 

out of the last block of real storage. (The contents of low address storage is not d^~^ 

reliable after the execution of a stand-alone dump program.) 1 y 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



Start 



o 



Before executing, dump, 
or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 
X'OO'-X'BF' 




Mount tape on a tape 
unit ensuring that the 
number of tracks and 
density is identical to 
that used when the 
tape was produced 



Set address switches or 
set address in display of 
the tape unit 



See D-1 -F for Models 1 35, 1 45, 1 55-1 1 
<: and D-2-F for Models 11 5, 125 
and D-3-F for Model 158 




YES 






\ 



^ 

D 



o'\~/ 



1? .^^ 



^^- 



::? 



Dump program 
on card deck 



Place card deck in a 
card reader 



Set address switches or 
set address in display of 
the card reader to be 
used 



To next page 
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DUMPGEN AND 

STAND-ALONE 

DUMP 




From previous page 



Press the STOP key, 
the SYSTEM RESET 
key, and the LOAD 
key, in that order 



A wait state occurs if 
INTR YES is specified 
during generation of the 
dump program using DUIVIPGEN. 



The contents of REAL storage is 
printed in blocks of 2K bytes on 
the line printer specified in the 
ASSGN statement of DUMPGEN 
or the line printer made ready 
after entering the WAIT STATE. 
Other information is also printed 
depending on the type of dump 
program generated by DUMPGEN. 




YES 



Press the INTERRUPT 
key, or the START 
button on the printer 
desired as output device 



The DUMP is 
executed 



r 



The SYSVIS dump utility program 
is described under C-6 in this Section 



v. 



The following procedure executes the SYSVIS dump utility program. This 
procedure copies the PDS to tape or disk which can then be dumped to SYSLIST 
if required during offline debugging. It is also possible to dump the PDS directly 
to SYSLST. To ensure that the contents of the PDS and the allocations of the 
virtual address area are the same as they were just prior to the execution of the 
stand-alone dump the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 



Example 1 

//JOBDUMPPDS 

// ASSGN SYSOOO,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK,'PAGE DATA SET' 

// EXTENT SYSOOO 

// DLBL S01DISK,'BACKUP FOR PDS', 

// EXTENT SYSOOL1 1111 1 ,1 ,,0020,180 

// EXEC PDSDM 

/& 



Example 2 

//JOBDUMPPDS 

// ASSGN SYSOOO,X'cuu' 

// ASSGN SYS001,X'cuu' 

// DLBL PDSDISK,'PAGE DATA SET' 

// EXTENT SYSOOO 

// TLBL S01TAPE,'BACKUP FOR PDS' 

// EXEC PDSDM 

/& 




V^. 



YES 



Use the SYSVIS dump to 
copy the PDS to disk. 
See JCS example 1 



Use the SYSVIS dump to 
copy the PDS to tape. 
See JCS example 2 



Wait for message 0V20D 
on SYSLOG then press END 



Save the copied PDS for your 
system programmer and /or 
IBM CE/SE. He may need 
it to complete offline 
program debugging. 



Continue normal processing 
with the next job 
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PDAIDS TRANSIENT DUMP 

PDAIDS (problem determination aids), are routines especially designed to 
provide specific information useful during offline debugging. These routines 
consist of four trace routines, which are described in Section 2-B of this manual, 
and one routine called the transient dump program. 

Transient Dump 

This program is designed to dump, on a program check, areas of the supervisor 
before they^ are altered. The dump provides: 

• the 1 6 general registers 

• the 1 6 control registers 

• the first X'20F' bytes of low address storage 

• the logical transient area (with the label LTA) 

• ^he physical transient area (with the label PTA). 

This information may be provided on either a printer or a tape unit. When tape 
is used, the tape must be processed by the PDLIST utility program to provide 
readable output data. PDLIST is described in Section 2-B. Both the printer and 
tape modules are reusable, that is a dump occurs with each program check until 
the function is reset. 

The printed dump output is non-translating. 



System requirements 

Because the Transient Dump program is a PDAID function, it requires the 
PDAID initializing phase and a PD area. Refer to "System Requirements" 
for Trace Routines in Section 2-B-l. 
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TRANSIENTDUMP Initializing the transien t dump 



Initializing is done by calling the PDAID program via the job control statement 
// EXEC PDAID. 

The parameters for the dump may be entered through SYSLOG or through the 
card reader assigned to SYSIPT. 

Note: No other PDAID can be executed when the transient dump program is 
initiated. 



G 



If SYSEPT is to be used, the card deck must be punched as follows. 

Punch desired keywords and parameters, as shown in example 1 , into cards. 
Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of 
a card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last entry of the last card must be GO and the last 
card must be followed by a /* card. 

Note: If an incorrect parameter is read from a card, corrections are requested 
on SYSLOG. 



When the main phase (PDAID) has been loaded into any free partition (one must 
be made available), the following message is issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

• TD Initiates transient dump. 

• XX Terminates PDAID. 

• END key Indicates that the parameters are to be entered via SYSIPT. 



o 
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Selecting the Output Device T R A N S I E N T D U M P 

The initializer keyword OUTPUT DEVICE selects an output device, which must; 
be specified by channel and unit address, not by symbolic unit. When an output 
device is specified, the initializer checks the address against the supervisor PUB 
and automatically selects the appropriate module for the unit type (tape or 
printer). 

Once the transient dump program has been initiated, it is given control each time 
a program check interrupt occurs. When it has control, the transient dump 
program has highest priority, and the system accepts only external interrupts. 
All system processing is suspended and the operator must ready the transient 
dump output device. 

When to use 

Use the Transient dump when you suspect coding errors in the transient routines, 
for example, your own error recovery routines for devices not supported by IBM. 
The information obtained from the dumps will help during offline program 
debugging. 

Terminating the transient dump 

The transient dump program can be terminated by re-initiahzing the PDAID 
program (// EXEC PDAID), and responding to the message PDAID= with XX. 
It is also possible to reset (terminate) the transient dump by loading one of the 
PDAID trace routines. 

The following illustration represents the action of the transient dump program if 
a program check interrupt occurs in the LTA. 
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TRANSIENT DUMP 



16 general registers 
16 control registers 



Line printer 

or 

magnetic tape 



527 bytes decimal of 
low address storage 



Supervisor transient areas 
(Refer to Section 4 for details) 



Pictorial representation of the information that is dumped. 



Real Storage 



Low Address Storage 



Model dependent 
log out area 



Supervisor Transient 

Area 

(LTAandPTA) 



Background 
Partition 



^ 



> 



SUPERVISOR 
AREA 
(Refer to 
Section 4) 



J 



/IF TK 



Keyword 


Parameter 


Meaning 


Default 


PDAID 


TD 
XX 


Initiate transient dump. 
Terminate function 


Function 
continues. 


OUTPUT 
DEVICE 
(Note 2) 


CUU or X'cuu' 


Use sfsecified output device for output of 
transient dump function. 




GO 
(Notel) 




End of initializer keyword entries. 

/ 





Note 1: GO is an invalid response to a request for a console correction to card input. 

Note 2: A printer or tape output device must be specified for transient dump, 

CUU or X'CUU' notation must be specified by channel and unit address, 
and not by symbolic unit. 

Two examples of initiating the transient dump immediately follow the flowchart shown opposite. 
Table A-4. Table of parameters for initializing the Transient Dump 
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TRANSIENT DUMP 
Initializing the Transient Dump 



// JOB DUMPTA 
//EXECPDAID 



4C10DPDAID = 



Enter XX 
and press 
END 



Enter TD 
and press 
END 



Press 
END 



4C1 ID OUTPUT DEVICE = 






Terminate 
Transient Dunnp 



Select output 
device 



Transient Dump 
is initiated 



Print the Transient 
Area 



Read Parameters 
fromSYSIPT 



A-4 F 




//EXECPDAID 

PDAID=XX 

/* 

II ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

r 




The LTA and PTA will be 
dumped on the selected output 
device if a program check interrupt 
occurs in the transient area 
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TRANSIENT DUMP Job stream examples '\^ y 

The following two examples show job stream to initiate the transient dump 
program. 

Example l,viaSYSIPT: 

//J0BCARDINP7 

// EXEC PDAID Calls for initializer. 

PDAID=TD Calls for transient dump function. 

OUTPUT DEVICE=OOE Specifies printer output. 

GO Signals end of input. 

/& 

Note: A dump is given on all program checks. 

Example 2, via SYSLOG: 

//J0BTYPINPT6 

// EXEC PDAID Calls for initializer. 

PDAID= Console requests function. 

TD and END key Operator specifies transient dump function. 

OUTPUT DEVICE= Console requests output device. 

OOE and END key Operator specified printer output. 

An output device must be specified for the transient dump fiction. 

If this is a 3211 printer and the printer's indexing feature is used, /r~^, 

it may occur that not the full length of every line of the dump is 

printed. This Joss of characters can be avoided by disabUng the "^ 

indexing feature. This is brought by loacfing a new FCB image into 

the printer's FCB in one of the following ways; 

Using the SYSBUFLD program. 

This method is to be used when the transient dump is entered via 

SYSIPT. The job stream as shown in example 1, 

would than have to be as follows: 

// JOB 

// EXEC SYSBUFLD 

FCB SYSxxx,phasename 

/* 

// J0BCARDINP7 

// EXEC PDAID 



Using the LFCB command 

This method is to be used when the transient dump is initialized 
by means of the console printer keybord (SYSLOG). The job 
stream as shown in example 2 would then be as follows: 



LFCB X'cuu',phasename 
// J0BTYPINPT6 
// EXEC PDAID 



* 

phasename — the name by which the FCB image is cataloged. 



:-^ 
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TRANSIENT DUMP 



o 





KENSDUMP 




12/06/73 












/^/>/l/l? 


/Mit^UCft/' ■^^^!<^ 




GR 0-F 


00040684 


00008620 


00040298 


00040308 


000085B1 


08040300 


00000000 


OOOO840A 








^ 






000084 BC 


00000008 


00040280 


00040688 


00040078 


00000008 


80008300 


000082E8 












CR 0-F 

000000 
^ 000030 


004000FF 
OOOOFFFF 

00000000 
00000000 


00OOE64O 
00000000 

00000000 
00000000 


FFFFFFFF 
00000000 

00000000 
07OF2000 


FFFFFFFF 

00000000 

00000000 
0000090C 


00000000 
00000000 

00000000 
000087AO 


00000000 
00000000 

000004A0 

ocoooooo 


00000000 
C2000000 

071DOO0O 
00003AB8 


00000000 
00000200 

0004044A 
00000000 


040COOOO 
FE3BD600 


00002876 
055C0E26 


/^XU^ <M/^S\^/ 




107000000 


000682F6IL, 


O46C6066 


ftoodWi**^ 


• 000060 


040COOOO 


OOOOOBCC 


ooocoooo 


0O00A5OC 


04080000 


0000013A 


040C0000 


OOOOOBIO 


00000540 


00000080 


00020007 


00060001 \ 




000090 


12042003 


00020000 


00000000 


OOOOOICC 


00000000 


00000000 


20000060 


000002C0 


OOOOOOOO 


00000100 


00000130 


oooooooo \ 




_ OOOOCO 
• OOOOFO 


00000000 


00000000 


00000000 


00000000 


00000000 
00000000 


00000000 
00000000 


00000000 
00000000 


oooooooo 
oooooooo 


OOOOOOOO 
OOOOOOOO 


OOOOOOOO 
OOOOOOOO 


OOOOOOOO 
OOOOOOOO 


oooooooo \ 
oooooooo 












000120 










30000000 


00000000 


00000000 


oooooooo 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


oooooooo 




_ 000150 


/^;y^ S/ /,.y^ 


a/ /.T^ 


30000000 


00000000 


00000000 


oooooooo 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


oooooooo / 




• 000180 




<y jv^'tje^ 




' 


DOOOOOOO 


00000000 


00000000 


oooooooo 


OOOOOOOO 


OOOOOOOO 


oooooooo 


oooooooo / 




OOOIBO/ 


'l/t'U^ A^^'^,' -».»._> o^ 


^i^^^u^a^ Dooooooo 


00000000 


00000000 


oooooooo 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


oooooooo / 




_ oooiEor 


ir^^ /, 


B^M^'.K. **■ 


'"^ / 


♦"^v^^XKffWC 


30000000 


00000000 


00000000 


oooooooo 


OOOOOOOO 


OOOOOOOO 


oooooooo 


oooooooo / 




LTA Si 
. 0082E8 
• 008318> 


yCCU<A<^t^ C^ 


9T013002 


28004590 
4710F08A 


F2669101 30044710 F09495FE 
91023002 4710F080 9108A087 


700047B0 
4710F076 


= ?(ZFt 

F0389551 
9H0A087 


^ 




_J->^ 




80044780 
47E0F05E 


F038D300 
94EFA087 


F4188004 
0A0B9S50 


SB5BC206 


D7C5D540 


'9550F418 


4780F0B6 


/^6<>8U8 


F4184770 


F0705860 


20080201 


40266006 


4110F41A 


OA024110 


F42A94F7 


A0870A02 


4110F43A 


94F03002 


OA024110 


F43294FE 




^ / 008378 


30020A02 


4110F422 


0A020A00 


91801002 


4710F0A6 


OA079120 


10024710 


F0B007F9 


92FFF419 


07F94160 


F3F04060 


100A4590 




^,j -«/0083A8 
jO" 008408 


F09A9108 


F2D74710 


F00C0605 


40204020 


4780F038 


96044003 


47F0F03B 


9104A087 


47E0F0EC 


94FBA087 


47F0F104 


4160F3F8 




4060100A 


4590F09A 


4160F400 


4060100A 


4590F09A 


95FFF419 


4780 F038 


9118A0e7 


4770F11C 


91112014 


4710F126 


0503F2EE 




F40E4780 


F12CD20S 


FZFZFtiW 


D5054020 


F4084780 


F234D505 


4020F2F2 


4770F15A 


0505F2F2 


F4124770 


F2349110 


30024710 




• 00 8438 


F15A9112 


201447E0 


F234076B 


F26AF26A 


9280F288 


9203F282 


0201F286 


8OO4920A 


F28AD201 


F2848000 


9206F291 


0205F2B4 




008468 


F2069201 


F2899550 


80044780 


F1B89218 


F2919214 


F28A0217 


F2BEF2D6 


9204F289 


926CF30C 


95538004 


4770Fla8 


9209F291 




_ 008498 


9205F289 


925DF3DC 


D205F292 


40200200 


F2A58005 


D201F29E 


400B0201 


F2A24012 


0201F2AO 


40010200 


F2A44000 


D203F2A6 




• 0084C8 


400ED201 


F2984026 


95508004 


4770F214 


D209F2AA 


40300602 


40004000 


4780F234 


07024000 


4000D733 


40084008 


9250F3DC 




0084F8 


47F0F230 


0213F2AA 


40300602 


40004000 


4780F234 


07024000 


4000D73B 


40084008 


4590F24A 


9110A087 


4710F240 


96044003 




_ 008528 


02054020 


F2F247F0 


F0380203 


F266F3DC 


18514110 


F2660A2C 


9180F268 


4710F262 


aA071815 


07F958A0 


001458B0 


A0885830 




• 008558 


B01C4110 


F3E09118 


A0874780 


F2A24000 


10064590 


F3821821 


45E0F394 


18444347 


00008940 


00014844 


30345A40 


303047F0 




008588 


F0B69180 


AOS94710 


F0701820 


91033002 


4740F34E 


9104 A058 


4710F32E 


91013004 


4710F320 


1BDD18C0 


412CD000 


95002000 




- 0085B8 


4770F320 


58220000 


95FF2007 


4780F2F0 


95202014 


4740F2F6 


95282014 


4720F2F6 


96013004 


07F99532 


20144770 


F3184SE0 




• 0085E8 


F39495FE 


700047BO 


F3180300 


F4188004 


9560F418 


4780F2F0 


41DD0004 


47F0F2C8 


94FE3004 


18205822 


000047F0 


F34E5820 




008618 


F4AC9500 


20044780 


F34A9102 


A05847E0 


F070582Z 


000047FO 


F34E5822 


000495FF 


20074780 


F0709520 


20144740 


F3669528 




. 008648 


20144700 


F0700201 


10062006 


45E0F394 


1B664360 


70008960 


00014846 


30345A40 


30304160 


F2064060 


F3F24160 


F2EE4060 




• 008678 


F3FA07F9 


487A007C 


48SA002E 


48887002 


487A004A 


0200F3BB 


7000 1B77 


43720007 


91012006 


47E0F3BC 


41770000 


1A781A77 




00a6A8 


4A7A004C 


1B884387 


00008980 


00034A8A 


004007FE 


00000000 


00000000 


00300400 


00001500 


OOOOOOOO 


OOOOOOOO 


20000000 




. 0086D8 


040002D6 


20000018 


020002EE 


2000000C 


07000400 


20000001 


00000000 


0000E5D6 


03F14040 


40404040 


00005B5B 


C206D7C5 




• 008708 


D5F15B5B 


C2D6D7C5 


D5C45B5B 


C201C3O6 


D7E35B5B 


C206D4E3 


F0F15B5B 


C20604E3 


FOF50000 


OOOOOOOO 


00005C00 


012C000O 




008738 


84000000 


92600004 


00006060 


C2C76060 


C3D6D409 


C5C74040 


C2C740C1 


C4C4D940 


C9E240F0 


F0F0F4C1 


F003C203 


E3E80740 




_ 008768 


40C8C5E7 


40D3C5D5 


C7E3C840 


C9E240F0 


FOFOF060 


D74BC44B 


604040C1 


09C5CIOO 


000020F2 


F14BF1F3 


4BF1F660 


80041224 
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• 008E60 


5B5BC1C2 


C5D9E9F1 


28005890 


00144890 


908458C0 


008048A0 


905A9287 


AOOO9102 


903547E0 


B02E48A0 


C05847F0 


B03248A0 




008E90 


906E4AA0 


905A1B88 


BF87A005 


58108O2C 


4570B068 


48F0C046 


58E0C004 


9280AOOO 


9127A008 


4780B05C 


9283A000 


5860C000 




_ 008EC0 


D2016006 


B0C407FE 


95FF1002 


4780B09A 


1B554350 


10028950 


00035A50 


C0249500 


50044780 


B0B89SFF 


50004780 


B09A1B44 




• 008EFO 


43405000 


185447F0 


80764111 


000895FF 


10004770 


80689283 


A0009680 


A00148A0 


905A94DF 


A00807F7 


5010802C 


0AO348AO 




008F20 


905A07F7 


D9C 10201 


00BA3000 


4A20905A 


18A248F0 


C00847F0 


B23C4100 


B29094AD 


00084570 


B14AD508 


802AB342 


4780B21A 




^ 008F50 


DS05802A 


B3364770 


B14AiaA0 


4850C02C 


4S60907C 


41AA0010 


41660010 


D501B031 


B3424780 


B120D501 


B031A002 


4770B142 




• 008F80 


9180600F 


4780B1A8 


4140B21A 


4100B208 


9226B267 


9220B264 


4570B14A 


9260B264 


07F446S0 


BI0492F2 


B2ABBE07 


B2614100 




008FBO 


B260BE07 


B31F4100 


B02ABE07 


B2710708 


B02AB02A 


4100834C 


BE07B269 


4110B316 


0A0F9180 


10024710 


B17C0A07 


9120B318 




_ 008FE0 


4710B21A 


9218B267 


9101B31A 


4780B19C 


4100B270 


BE07B31F 


47F0B15E 


D608B02A 


B3424100 


B2A807F7 


4100B2C0 


91029035 




• 009010 


47E0B1E6 


4120000F 


4B20C02C 


4830C02C 


89300004 


4A30905A 


41330010 


05013002 


A0024770 


B1E29601 


3000960C 


300F9210 




009040 


30014620 


B1C89580 


A0004780 


B14A9110 


A0OF4770 


B14A9601 


A00048F0 


C00A47F0 


B23C4100 


B2FE9218 


B2679220 


B2644570 




_ 009070 


B14A9260 


82644 7F0 


B03E48F0 


C04658E0 


C0049280 


D0009127 


00084780 


B2329283 


D0005860 


C00092C1 


600707FE 


91400008 




• 0090A0 


4710B248 


94F 80008 


4BA0905A 


42A0902F 


91029035 


4780B21E 


42A0CO5B 


47F0B21E 


090090F0 


60000018 


010091AC 


60000004 




0090D0 


0A0OSE8A 


20000009 


F0D7F6F0 


C440C905 


E3C5D9E5 


40D9C5D8 


40404040 


40FQF0F0 


F1C9F4F0 


C44009C5 


0BE4C5E2 


E340C3C1 




_ 009100 


D5C3C503 


40404040 


F1E2F0F1 


C440C9D5 


E5C103C9 


C440E2E3 


C1E3C5D4 


C5D5E340 


F1C9F3F2 


C440C1D9 


C5C140D5 


D6E340C1 




• 009130 


C3E3C9E5 


C5404040 


F108F6F2 


C940C3C1 


05C3C5O3 


40C6D609 


40D7D6E6 


C5D940D7 


D906C709 


C1D440C9 


C70506D9 


C5C4F0D7 




009160 


F8F9C940 


C961D640 


C3C1D5C3 


C5D340C9 


C7050609 


C5C40003 


81000800 


00040000 


90C0O00O 


90D8F0F1 


F2F3F4F5 


F6F7F8F9 




_ 009190 


C1C2C3C4 


C5C6C3C1 


05C3C5D3 


C9C7D5D6 


D9C54040 


40404040 


40404000 


C1094040 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 




• 0091C0 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


oooooooo 


OOOOOOOO 




0091F0 


00000000 


00000000 


00000000 


00000000 


00000000 


00004040 


40404040 


40C3C3E2 


E67EF0F1 


F1F0F0F4 


F0F4F2F0 


F0F2F0F0 




^ 009220 


FOFOFOFO 


40C3C3C2 


7EF0F4F0 


F4F0F040 


E2D27EF6 


F1F6F1F0 


FOFOFOFO 


FOFOFOOO 


F0D7F0F8 


C1404040 


40C9D5E3 


C509E540 




• 009250 


D9C50840 


E2E8E2D3 


E2E37EF0 


F0C56OOO 
















/^/^<^^ 




Transient Dump output 

This example shows the output obtained from the transient dump program. (The dump is 
output when a program check occurs in the transient area.) 

The programmer's remarks on this example indicate the main points of interest to aid offline 
debugging, however this depends on the error symptoms and system environment. 



o 
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SUPERVISOR 

COMMUNICATION 

MACROS 



Dumps of, and changes to Real and Virtual Address Areas 

PDUMP (partial dump) macro 

This macro instruction provides a hexadecimal dump of: 

• The general purpose registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The virtual storage area contained between tv^o address expressions. 

The addresses can be expressed in decimal or hexadecimal or in register notation 
and need not be confined to any one partition. 



Name 


Operation 


Operand 




(name) 


PDUMP 


address 1 , 


address 2 






(r) 


(r) 



Address 1 specifies the start address of the 
storage to be dumped. 

Address 2 specifies the end address of the storage 
to be dumped. 

(r) one or both of the addresses can be 

specified in any of the general registers. 

The contents of registers 0-1 are destroyed, but the CPU status is retained. Thus, 
PDUMP furnishes a dynamic dump (snapshot) that is useful for program checkout. 
Processing continues with the next user instruction. 

The dump is always provided by SYSLST on 121 -byte records. The first byte 
is an ASA control character. If SYSLST is a disk drive, the user must issue an 
OPEN macro to any DTF assigned to SYSLST after each PDUMP that is 
executed. The OPEN macro updates the disk address maintained in the DTF table 
to agree with the address where the PDUMP output ends. If OPEN is not issued, 
the address is not updated, and the program is canceled when the next PUT is 
issued. 

The specified addresses are checked against the end address of virtual storage. If 
address 1 is higher than the end address of virtual storage, or if address 1 is higher 
than address 2, the PDUMP macro results in no operation. If address 2 is higher than 
the end address of virtual storage, address 2 is automatically set to that address. 

If address 1 and 2 are identical, only the contents of the general registers, the 
control registers and floating point registers are dumped. (Floating point registers 
are dumped only when the supervisor supports the floating point option.) The 
dump output can be either standard (non-translating) or translating, depending on 
the dump program cataloged in your system transient library. 

Note: Addresses for this macro may not be specified by register notation for 
programs eligible to run in the SVA (shared virtual area). 






2.32 Serviceability Aids. 



Dumps of, and changes to Real and Virtual Address Areas 



o 



When and how to use 

PDUMP is useful when you need to know the contents of specific virtual storage 
areas at specified points in the program during program execution. For example, 
you may want to examine the contents of storage areas that are being modified 
during program execution, such as I/O areas. 

The following example illustrates the use of the PDUMP macro. 



SUPERVISOR 

COMMUNICATION 

MACROS 



003CTE 02«F C2BF C2BE 04AC1 04AC0 
003C84 0227 C2BF CD4F 04AC1 05S51 



400 OUT CANCEL 

405 **«•*•••••****•«***««•***•••*«•****•••*«**«*•«•*•••*•••**•***•••***«•** 

406 nOOP TIMER ROUTINE* 

407 *•*•*****••«**********•*•********••***••••***••••••••••••*••****•••*•*• 

408 TININTR NVC BUGSWARN|BUGSMARN-1 

409 NVC BUGSHARNt40lfCHKPTMRN 

410 PUT TYPOUTl 

415 PDUMP L0aPCNT.L00PCNT«3 DUMP LOCATIONS USED AS COUNTER 

420 * FOR THE LOOP AT EACH TIMER INT. 

421 EXIT IT 

424 •**•**•*****••••**•***•*«•••*******«*********•••****•**********•••***«* 

425 *END OF LOOP ROUTINE* 

426 *********************************************************************** 



(./Tx/S^ 



This source code listing shows the PDUMP macro where the programmer needed 
to know the contents of an area used as a counter. 

The following dump printout was obtained when the program was executed. 



• 




KENTQMSl 




12/0ft/73 












PAGE 


1 


• 
• 


GR 0-7 
GR 8-F 
FP REG 
CR 0-7 
OR 8-F 

041680 


0004IE10 
OOOOOOOl 
00000000 
004000FF 
OOOOFFFF 


00041E08 
0000CA34 
00000000 
0000E640 
00000000 


00000049 
00000013 
00000000 
FFFFFFFF 
00000000 


00000000 
4004007A 
00000000 
FFFFFFFF 

00000000 


00000000 
0004107A 
00000000 
00000000 
0000 .000 


00000050 
07C8C1E2 
00000000 
00000000 
00000000 


OOOOOOin 
8004050E 
00000000 
00000000 
C2000000 


00000002 
O00'i22F8 
00000000 
00000000 
00000200 

OOO0CA34 




'V^x/^/i^ 






Restriction: 

The message INVALID ADDRESS SPACE is printed on the dump output if the 
dump includes storage areas considered to be invalid address space. 

The definition of invaUd address space is listed under "Restrictions" in the 
description of the ALTER command. 
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Dumps of, and changes to Real and Virtual Address Areas 

DUMP macro 



SUPERVISOR 

COMMUNICATION 

MACROS 



This macro, when assembled into your program and executed, will dump the 
following system information: 

• The general registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The active communication region address (see Section 4 for a description) 

• The supervisor 

• The PD area (if PD is specified for the system; see B-3 in this Section) 

• The label length 

• The partition identifier BG, F4, F3, F2, or Fl 

• The temporary real or virtual partition issuing the macro. 



Name 
(name) 


Operation 
DUMP 


Operand 



If the program or main task issued the macro, the job step is terminated 



JDUMP macro 



Name 
(name) 


Operation 
JDUMP 


Operand 



If the program of main task issued the macro, the main task (the whole job) is 
terminated and a dump is made of those areas listed in the description of the 
DUMP macro. 
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O 



Dumps of, and changes to Real and Virtual Address Areas 






The following considerations apply to both the DUMP and JDUMP macros: 

1. If a subtask issues these macros, the subtask is detached, the job step or job, 
respectively, is not terminated, and the dump described above is executed. 

2. The dump is always provided on SYSLST, which, if disk or tape, must be 
OPENED. 

3. If either macro is issued by a program running in real mode, the temporary 
real partition is dumped. However, if these macros are issued by a program 
running in virtual mode, the whole virtual partition is dumped. 

4. The dump output can be either standard or translated, depending on the type 
of dump cataloged into your system during system generation. 

5. The LTA (Logical Transient Area) is used to contain'the dump program; 
therefore, the LTA printed in the dump will always contain a B-transient 
$$BDUMPB (if the dump is directed to a line printer or tape unit), or 
$$BDMPDC (if the dump is directed to a disk drive). 



SUPERVISOR 

COMMUNICATION 

MACROS 



o 



When to use 

By coding these macros into your source listing you can ensure that a dump of 
the supervisor and of the partition issuing the macro is executed. 

For example, you may require a partition dump when certain conditions arise 
during program execution. This is accomplished by programming a branch to 
the DUMP (or JDUMP) macro written in the source listing. The JDUMP 
macro must be used when it is necessary to terminate the job after entering the 
routine that issued the macro. The DUMP macro is used when termination only of 
the job step is required, for example, during program testing. After termination of 
the job step in which the macro was issued the job steps after that are still 
executed. 
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Intentionally Blank 
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Two series of trace routines are provided on the System/370: PDAIDS and 
> SDAIDS 

These aids enable information to be obtained from the system at the time of a 
malfuiiction. They are aids for further error isolation, and are usually initiated 
during a rerun of a troublesome program after a first analysis of the problem. 
The type of trace to use for a particular problem depends on the result of the 
first analysis and how much more information is required to help in further 
isolation of the error. 

This section is divided into two parts: 

Part 1 describes the PDAIDS, and part 2 describes the SDAIDS. 



Trace Routines 

PDAIDS 




PART 1 PDAIDS 

General description 

There are four trace routines that can produce printed output of certain events 
which occur during the execution of programs. 

The trace routine will: 

• Record I/O operations (I/O trace) 

• Record the order in which phases and transients are called (Fetch/Load trace) 

• Record the order in which supervisor calls (SVCs) are executed (Generalized 
SVC trace) 

• Record the order in which either an SVC or an SVC 31 , and I/O 
interrupts occur. (QTAM trace). 

On the occurrence of an event, an entry is generated which, by selection of the 
trace, can be recorded on magnetic tape, printed on a line printer, or preserved 
either in the PD area or, if specified, in an alternate area of real storage. 



Caution 

The effect on the operation of programs currently running in the system 
that are time dependent, for example, a program using MICR or teleprocessing 
as input/output, must be considered before using this serviceability aid. 
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Trace Routines 

PDAIDS 



Pageof GC33-5380-1, 
revised JunI 30, 1974, 
by TNL SN33-8780 



System requirements 






Before any PDAID function can be executed, the following requirements must 
be met: 

• During the system generation, specify a minimum value of 1400 in the PD 
parameter of the FOPT macro. (The maximum value is 10,240), 

• If data provided by the trace routines is recorded on magnetic tape, use 
the PDLIST program after tracing is complete to obtain a printout of the 
tape. 

All PDAID modules are distributed by IBM in the core image library. 
They are self -relocating for initiaUzation in any real or virtiual partition 
(6K or greater) of a multiprogramming system. 



Restrictions: More than one PDAID trace routine cannot operate concurrently. 
This also applies to the PDAID Transient Dump program described in Section 
2-A-4. Therefore, more than one program rerun must be executed if more than 
one PDAID function is used to gather information about a failing program. 

Using PDAID and SDAID concurrently: IF SDAID is active it must first be 
terminated before initiating a PDAID trace in core-wrap output mode in an 
alternate area. 



Modes of output 



Line printer: (not available as output mode for QTAM trace) Examples in this 
section show the trace outputs when the output device is a line printer. An 
asterisk on the print-out indicates that at least one event (trace entry) has been 
overwritten. This occurs when an overflow is caused in the trace table in the 
PD area (described in B-3) or in an alternate area. This may occur when the trace 
output device, or its control unit, or channel, is shared with other programs 
running simultaneously. 

If the printer is not ready or has an error condition, message 4C24A NO I/O TO OD 
is printed on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the printer is made READY. 

Magnetic tape: This mode of output collects and writes on an unlabled tape the 
trace entries that occur during execution of a job stream. 

The events are written on tape in core image (unprintable) format. 

The tape must be processed using the PDLIST utiUty. The tape unit must be 
assigned temporarily or permanently to SYS005 and SYSLST assigned temporarily 
or permanently to a line printer in order to obtain readable Ustings of the events 
traced. Examples in this section show the output format after using the PDLIST 
utility. 

If the tape unit is not ready or has an error condition the message 

4C24A NO I/O TO OD 

is issued on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the tape drive is made READY. 



\.-'y 



2.40 Serviceability Aids. 



m F 



Core-wrap: This mode of output preserves a fixed number of trace entries in either 
the PD area buffer or an alternate area taken from the main page pool. If the 
alternate area is specified, the PD area buffer is not used. When the area is full, the 
oldest entry is overwritten by each new entry. 

When core-wrap in the PD area is specified, the PD area must be dumped. The 
dump should normally be executed on the occurrence of a system malfunction 
when the last few trace event entries are required to aid offline debugging. 
Dumping and locating the PD area is described under B-3 in this section. 

Table B-3 lists the length of each type of trace entry, the locations, and the 
maximum number of entries that can be preserved in the minimum PD area 
buffer size. Use the table and a dump of the PD area to locate the oldest and 
newest trace entries. 



Trace Routines 

PDAIDS 




Core-wrap in an alternate area: If many events are to be recorded in the core- 
wrap output mode and the PD area is considered to be too small, specify an 
alternate area large enough to contain the trace event entries. 

Specifying and dumping an alternate area is described under B-4 in this section. 

When an alternate area is specified, the real storage taken from the main page pool 
is returned to the main page pool on termination of PDAIDS. Before the alternate 
area is released, its contents are dumped on the device assigned to SYSLST. 
(See "Termination of PDAIDS.") 






When to use the core-wrap output mode: This output mode is useful when no 
output device is available, or when time required by the output operation is not 
available. This would be the case for example, when a PDAID output device 
interferes with time-dependent programs example, when a PDAID output device 
interferes with time-dependent programs using the I/O channels. It should also be 
specified when only the last few trace event entries are necessary to aid in offline 
debugging. (This reduces the task of searching through masses of output.) 

Terminating PDAIDS 

Any trace routine can be terminated by re-initializing the PDAID program with 
the job control statement // EXEC PDAID, and responding to the message 
PDAID= with XX. It is also possible to reset (terminate) one trace routine by 
loading another. 

Terminating core-wrap output in an alternate area 

When the core-wrap output is selected, SYSLST must be assigned to either a 
line printer, a tape unit, or a disk drive, before responding with XX to the 
message 4C10D PDAID=. 

For example: 

// ASSGN SYSLST, X'OOE' 
//EXEC PDAID 

If SYSLST is unassigned, the contents of the alternate area is overwritten when it is 
returned to the main page pool. 

PDLIST 

Whether the PDAID function uses a printer for its output device, or the PDLIST 

program prints the output of a tape unit, the data printed out is identical. 

PDLIST is initiated by the command: 

//EXEC PDLIST 

PDLIST then prints on SYSLST the contents of the tape reel (it can include the 

output of more than one PDAID function) mounted on SYS005 . No tape labels 

are required. 

Note: The data can only be printed using PDLIST if the device assigned to 
S YSLST is a line prin ter. 
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Description and operation 



Input/Output Trace 

This trace enables the I/O activity of programs run under DOS/VS to be recorded 
for offline analysis. The format of the data recorded in the PD area either in a 
trace table or, when using the core-wrap output mode in a rotating buffer, is as 
follows: 

Length of one entry = 18 decimal bytes i 



On the occurrence of an I/O interrupt; 



Device 
Adqir 



— , , , 

l/OOLDPSW 



1 — I — r 

CSW 
J I L 



On the occurrence of a START I/O instruction 



E2 40 



Device 



1 1 \ 

CCB ADDR-R1 



1 — I — I — r 

CSW 

J I I L 



— Condition Code 

If the entry is made due to CSW stored 
on a START I/O instruction the CCW 
address in the CSW is set to zero. 

Notes: 

1. The PSW and CSW are described in E-2 of this Section. 

2. The CCB is described in chapter 6 of Section 4. 

3. General purpose register usage is described in chapter 10 of Section 4. 

4. The CCB address and the CCW address in the CSW are virtual addresses. 

Either of these occurrences is referred to as an I/O event. 

By selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 
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Trace Routines 

Tracing Options: The I/O trace function provides the following options: PDA IDS 

• Trace all I/O activity on the system. 

• Eliminate a maximum of three devices. 

• Limit trace to a maximum of three devices. 

The trace limiting options are specified by the initializer keywords IGNORE 
DEVICE= or TRACE DEVICE=. All I/O activity is traced if one of these key- 
words is not specified. The two keywords are mutually exclusive: when one is 
specified, the other becomes invaUd. 

The trace limiting options are invoked by specifying the channel and unit 
addresses (X'CUU' or CUU) of the appropriate devices. SymboHc device 
references (SYSxxx) are invalid. 

Note: If the trace output device is being used by a problem or control program 
simultaneously with the PD AID program, I/O events for the PDAID program 
are ignored (not traced). Because of this, it is not necessary to ignore the trace 
output device. 

When to use: Use the I/O trace to check that the I/O interrupts within your 
system are correct during the execution of programs. 

You could use it, for example, in a multiprogramming system where the status 
of I/O units is suspected of causing incorrect I/O interrupts. An I/O trace output 
will inform you about the sequence of SIO/ I/O interrupts and about the 
status of I/O units at the time of interrupt. 

The next two examples show the output obtained from an I/O trace. 




Serviceability Aids. 2.43 



Trade Routines 

PDAIDS 



OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 



1004094008000000 
1 004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
0000000004000000 
0000000004000000 
OOOOOOOC04000000 
0000000004000000 
0000000004000000 
0000000004000000 



OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070C20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F. jC'.^i/f^ g^^ ^ 104000000 



510 0000 5^(7 <^t*^S2<>^ 
SIO OOOOi 



108000000 
•04000000 



SIO OOOOOOOE00040910 0000000004000000 
SIO OOOOOOOE00040910 0000000004000000 



SIO OOOOOOOE" 



"0004000000 






SIC oooooooE fta<x^ eti^i^ 

SIO OOOOOOOE /*>** ^/o ^t^e^i/^^* ^/t^»^ 



«KtA«^ eU'3Z/ 



^\ 



381 070C2O0OO000O9OC 10040aB80CO0OOO0 



/sioooom 



SIO O0OOOO0E00040910 0000000004000000 



SIO OOOOOOOE00040910 0000000004000000 
SIO 00O00O0E0OO4091O 0000000004000000 
SIO OO0O0OOEO0O4091O 0000000004000000 



OOE 070C20000000090C 

J040000BT>s. OOE 070C20000000090C 

OOE 070C20000000090C 

OOE 070C20000000090C 

OOE 070C20000000090C 

OOE 070C2O000000O90C 



1004094008000000^ 
1004094008000000 / ,fi,^J^ 
1004094008000000 V •frv^'i. 
1004094008000000 \ OO £ 
1004094008000000 I 
1004094008000000 ' (fie /S /tr)t 



An example showing an I/O trace output printed on a line printer used as the 
PDAID output device. 





1 








HHIHHI 








D 
I 


C^ 0-7 
^ C< 8-F 

POAREA 

009480 

0094AO 
1 009 4C0 

009460 

009 500 
1 009 520 

009540 

009 560 
k 009580 

0095&0 

0095:0 
1 0095EO 

009600 

009 620 
1 009640 

039660 

009680 
1 009 6A0 

009 6C0 

0096E0 
1 009 700 
' 009720 

009740 
1 C09760 
' 009780 

009710 
1 0097:0 
' 0097E0 

009800 
1 009820 
' 00 9 840 

009860 
1 009880 
' 0098A0 

0098C0 
1 0098E0 
' 009900 

009920 
1 009940 
' 009960 

009980 
^ 00994 
' 009 9:0 

0099E0 


804000E0 O0OOF6O0 
0000^300 00000000 

i 
E3D37EF3 F8F07000 
00003000 00004798 
FFFFFFFF FFFFFFFF 
FFFFF=80 800047AE 
50C091C4 58&00014 
47F09084 95FFA0O2 
00004111 000058:0 
58B10020 19AB4740 
B003t7-0 910CBFB7 
078A070& 49209038 
078A3501 B0069l:8 
918307=^ 58B091B8 
0018^248 00029430 
47F09110 58&1O01C 
00009924 000099FC 
8AF00330 OOOOOOOE 
8AF0OOOO OOOOOAOO 
20003000 09620000 

000= 07 or. ?fiOooonn 


FFFFFFFF FFFFFFFF 00000000 00000000 00003000 00000000 
00000000 00000000 00000030 00000000 :2000000 00000200 

10b0099FF 0000479C 3000153E 0O0OB44E OOnQOr"^*' nnjjnoEnp 
00OO3AA4 00001030^D7:4:iC9 C4C9 E3E6 (*T^3009 FFFF?n=f^--^ 
FFFFFFFF 3 FF /^ ."FFFFFFF FFFFFFFF 
47F0915C 581 CfZ,/' / <r/^V^>-/ 103000BA 50A0905C 
48AOA040 49; ^ W< W OUX,rf^;eaM ,730910c 41AA0008 
4733910C IBI yn / V _^ // I0805AC0 A024581; 
91C49120 10( /^^tttxyz. /a.,^'^ 1FA70041 47809110 
90FE41CB 00' / )03C58B0 91B8BEA7 
B0454770 931 ;8A0905C 49209036 
078A070A 49; i01C3502 B00391C0 
078A58B0 91B841BB 001259BO 91BL4r43 915658B0 91B450B0 
44009068 502B0002 501B0006 D2013000 91B350A3 9O5:88A0 
80029120 10064710 919C9130 B0024773 9113D702 BOOBBOOB 
50AB0006 9133B3D2 47839192 47F090CA £2*00000 00009654 
C4E4D'.00 00002330 D5E7FFFF 0O0E070C 20000000 09620000 
370F230D 33333952 03300030 040^0003 — /^^^ /^.^ ^^/l^ 
OOOOOOOE 070C2000 OOOOMi^'OISOOSAFO ^^^ i^TO'^^ C*U.f<i/ ^ 
00000400 000OE240 OpetfOODE FF008AF0 00003000 O4OOOOOO" 
09620000 8AF0DB00 JiftfoOaOOOE ,g7pF2O00 00003967 00030000 


TL.3 80 + 






JITHf 

/ ;! 


:?:::■ :i/o ^^^ - 


#, .. #... 








.0......#. 






* 




g 






N>^.":!!!::::!s' :::: 




Tri; :: 0!. 




04000000 [E2400000 
000' ^^^w^ 

000 «^ ^ cs^ 

III 5^^ I/O 

080 . y^ \_^ 

000 

070 

0000: ^-t J UUUUUUOt 

8AF33300 OOOOOOOE 

8AF000OO 00000400 

20003000 09620000 

ooo;o7o: 20000000 

04003000 E2400000 
00003A=0 08000000 
FF003A=0 00000000 
070=2000 00000962 
OOOOOOOE 070C2000 
00000400 00O0E24O 
09623000 8AF00800 


OOOEFFOO 8AF00300 00003430 OOOOpOOE 070C2000 00000962 


..IJs .......0 


"A 


::x:::::::.::. :::: 




2/c o^v«tL gji-rvi-f^i.^ 04000000 000E070: 

J- /— ^ -1 / 00000000 04000000 

^/t*« ^^t/fy^L- L°0 '^J 00000962 00008AFO 

000000 09bi:Uo/o OOOU0400 0OOOE240 OOOOOOOE FF008AF0 

0EO70C 20300000 09620030 8AF00800 OOOOOOOE 070F2000 

300000 E2430300 OOOuFFOO BAFOOOOO 00000400 OOOOOOOE 

008AF0 08000000 0O0EO73F 20000000 09620000 00000400 

FF008AF0 00033300 04000000 OO0EO73C 20000000 09620000 

073F2000 30000962 00303330 04000030 E2400000 OOOEFFOO 

OOOOOOOE 070C2000 03003962 00008AF0 08000000 000E070F 

00000400 3000E240 OO00303E FF008AF0 00000000 04000000 

09620000 8AF00830 0030003E 070F2000 00000962 00000000 

OOOEFFOO 8AF00300 30303400 OOOOOOOE 070C2000 00000962 

000E070F 20000300 09623000 00000400 00O0E24O OOOOOOOE 

04000000 00OE07OC 20300330 09620033 8AF00800 OOOOOOOE 

00000000 34030330 E240300O 003EFF00 SAFOOOOO 00000400 

00000962 30008AFO 08000000 000E070F 20003000 09620000 

OOOOOOOE FF008AF0 00303030 04000000 O00E07OC 20000000 

OOOOOOOE 370F2000 00300952 00000000 04000000 00000000 


,,.0... 




, s ... 




















S 












s 








..S 




.0. ............. .... 


^ 


















...0 


s •••« 














S 







^^^^(e^i^T) 




1 








HHHBH 







\^ 



An example of an I/O trace executed in core-wrap output mode in the PD area. The 
PD area was dumped using the DUMP command. 



2.44 Serviceability Aids. 



o 



Fetch /Load trace 

The F/L (fetch/load) trace records the order in which phases and transients are 
called from the core image library under the control of DOS/VS. Issuing a fetch 
or load causes an SVC 1 , 2 or 4, and the format of data recorded is as follows: 

Length of one entry = 22 decimal bytes 



Trace Routines 

PDAIDS 



i 1 1 1 1 1 1 

PHASE NAME 
1 1 1 1 1 1 1 


SVC 
No. 


1 1 
SVCADDR 

1 1 


I 1 1 
LOAD ADDR 

II 1 


1 1 r 

ENTRY ADDR 

1 1 1 


sysIlog 
'9 



_x. 



AR.BG, F4, F3, F2, F1 
See note 4. 



.Entry address to give 
control to the phase. 




Address at which 
the phase is loaded. 



Call Address (This is taken from 
the SVC old PSW; therefore it is 
actually 2 bytes past the calling 
address.) 



■Value of the Supervisor Call (See note 3) 



Phase Name 



o 



Notes: 

1. At times, SVC 5, 6, 11, and 14 branch directly into the supervisor fetch or 
load routine. These are traced whenever they occur, and appear in the 
output of the trace; however, the calling address and SVC values do not 
indicate the actual fetch or load. 

2. Use of the REQ VEST key during the operation of the FjL trace may result 
in apparently erroneous data due to the supervisor action required to 
handle the request. 

In particular, supervisor calls that have already been recorded may not be 
completed, and part of the data put out by the specific phase may pertain 
to these incomplete SVCs. 

3. A list DOS/ VS S VCs can be found in Section 4. 

4. The SYSLOG ID is described in appendix B. 

When the data is recorded in the PD area, either in a trace table or, when using the 
core-wrap output mode, in a rotating buffer, the two bytes used for the SYSLOG ID 
is recorded between SVC ADDR and the LOAD ADDR. 



Serviceabihty Aids. 2.45 



Trace Routines 

PDAIDS 



On the occurrence of an event, an entry is generated. By selection of the trace 
output device, the event can be: 



Recorded on magnetic tape 
Printed on a line printer 
Preserved in the PD area 
Preserved in an alternate area. 



When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The F/L trace functions are: 

• Trace all SVC 1,2,4, and certain SVC 5,6,11, and 14 interruptions. 

• Limit the trace by partition (multiprogramming systems only). 

Trace limiting options are specified by the initializer keyw^ord TRACE PARTITION= 

These options are useful only when the user runs several partitions at once, and does 
not wish to trace all of them. If only one partition is operating at a given time, the 
default (trace all partitions) allows both the single partition and the supervisor to 
be traced. 

When to use: Use the F/L trace if you are not certain which phases are required 
for a particular program, or in which sequence they are called by the program. 
From the trace output you can see where the phases were loaded and their 
entry addresses. In addition you can check the logical use of the phases for the 
program. 

The next two examples show the output obtained from an F/L trace. 



£ "X 



2.46 Serviceability Aids. 



""^ 



Trace Routines 

PDAIDS 





VHHH^H 


^^m^B 










: // JOB POL I ST 




DATE 12/06/73 


CLOCK 20/31/54 






• ! // ASS6N SVS005,X«2*1« 

II MTC REW.SYS005 
_ 1 // EXEC POL I ST 




^/L ^ttOt. »yi £<i l^ 












6^ yiex, uJ»n p^ Bo/^/V' 






^ 1 //BCLOSE 2 C-040B4A 
! //BE0J3 E C-0*0B4C 


BG t-0082E8 E-0082FO 
BG L-00B2ES E-0082E8 


//BCL0S2 2 C-0084D6 BG L-0082E8 E-0082FO 
//BEqj4 2 C-00837C BG L-0082E8 E-0082F0 








• 1 //BEOJT 2 C-008^BA 


BG L-0O82E8 E^0082F0 


//BEOJ 2 C-008372 BG L-0082E8 E-0082F0 






_ i //BEOJSI 2 C-00847A 


BG L-0082E8 E-0082F0 


/JOBCTLA 4 C-00839E BG L-040078 E-041888 








/JOBCTLG ♦ C-040958 
• 1 /JOBACCT 4 C-041AE0 


BG L-041888 E-041888 
BG L-041B80 E-041B80 


/JOBCTLN 4 C-040958 BG L-04188S E-041888 
/JOBCTLG 4 C-0409S8 BG L-041888 E-04188B 






_ /JOBCTLF 4 C-040958 
! /JOBCTLJ 4 C-040958 


BG L-041888 E-041888 
BG L-041888 E-041888 


/JOBCTLG 4 C-040958 BG L-041888 E-041888 ^ 


(tKl7Kr) 




1 //BOPEN 2 C-040B42 BG L-0082ES E-0082FO 1 




^IHIHHI 


HHH 


^^^^^^^^^^^H 








An example showing an F/L trace output as printed on a line printer using 
PDLIST. (A tape unit was selected as output device for the PDAID.) 



o 






016C00 
014FEO 

-P.O.- 
009480 
0094A0 
0094C0 
0094E0 
009 500 
009 520 
009 540 
009560 
009580 
0095AO 
009 5C0 
0095E0 
009 600 
009620 
009640 
009650 
009680 
0096A0 
009 5C0 
009 6E0 
009700 
009720 
009740 
009760 
009780 
009 7A0 
O097C0 
0097E0 
009800 
009 820 
009 840 
009860 
009 880 
009-8A0 
009 SCO 
0098E0 
009900 
009920 
009940 
009960 
009980 
0099A0 
0099CO 
009 9F0 



DEBUGEX3 ■^r^ 10/05/73 



r/^ 



00000333 —SAME — 
00000000 00000000 00000000 



P/) eif^eJi [oooo^9F^ oo 



AREA 

-, — . w ^__^ 0000479C 
OOOOOOOO 00006940 00003KC4 00001003 
90ECD202 B0090025 D200B008 008B07FA 
FFFFFF30 FFFFFFFF 07FA070A 07FA070A 
4710909A 95FF90F5 078A95FF 90F5078A 
078A53B0 90EC501B 000C500B 0010D207 
0201B014 80029502 B0084770 90CE4111 
90F04740 90E258B0 90E850BO 90EC07FA 
FFFFFFFF 5B5BC2C5 D6D1F340 OB008908 
F4400200 88860000 87CO0OOO 87C8C6F2 
000087C8 C5F25B5B C2C5D6D1 F4400200 
0601F540 02008704 OOOC87C0 000087C8 
87C00030 87C8C6F2 5B5BC2C5 D6D1F540 
C2C5D631 F4400200 881A0000 87C0O000 
000087C0 O00O87C8 C6F25B5B C2C5D6D1 
5B5BC2:5 06D1F540 020087D4 000087CO 
881A00OO 87C00000 87C8C6F2 5B5BC2C5 
C6F25B58 C2C5D601 F4400200 881AOO00 
02008996 000087C0 OO0087C8 C6F25B5B 
87C8C6F2 5858C2D7 C3C8D240 02008A3E 
07400230 894 CO000 87CO0OO0 87C8C6F2 
000087C8 C6F2 ISBSB C2C4D4D7 C2C30200 
07C50540 
87C00D3O 
:206D4E3 
000087C0 
5B5BC2D6 
89EE0000 
C6F25B5B 
02008*32 
87C8CSF2 
540020B 
000087C8 
04E3FD=5 
87C 00000 
C2C3:536 
000087:0 
5B5BC2;3 
8A020300 
C6F2535B 
020B17D2 
87C8C6F2 
FOF 50230 
000087C8 



)00 OOOOOOOO OOOOOOOO , 



0000158E 
|D7:4C1C9 



0000B44 



C4C6E3E6 



FFFFFFFF 
47F09036 
95FF90F5 
B0005000 
0008501B 
00009584 
000087CO 
5B5BC2C5 
881AOO0O 
C6F25B5B 
020087D4 
87C8C6F2 
F4400200 
000087C8 
D6D1F540 
87C0O0OO 
C2C5D&D1 
000087CO 
5B5BC2C4 



1^0 00 00 C 
g^FFFFOO 



56 00009F02 
09 FFFFSBBO 




FFFFFFFF FFFFFFFF FFFFFFFF 

428090F5 58800080 91018042 

078A95FF 90F5078A 95FF90F5 

58800014 4880805A 4A8090F4 

0010581B 000C41BB 00165980 

0000973C 000099FC 0040FFFF 

0O0O87C3 C6F25B5B C2C5D6D1 

D6D1F540 020087D4 OO0087C0 

87C00000 87C8:5F2 5B5BC2C5 

C2C5D6D1 F4400200 BBIAOOOO 

000087CO 000087C8 C6F25B5B 

5B5BC2:5 D6D1F540 020087D4 

881A0000 87COO00O 87C8C6F2 

C6F25B5B C2C506D1 F4400200 

020087D4 000087ri nnnnoiro 
87C8C6F2 5B5B:2 ^^ ^:^^ &tv^ 



.... 




.5.. 


.0... 


.5 




..#...#. 


..K. 




4 


.0. 


.S...Y#. 


.... 








....ESBE0J3 .. 



HF26SBEQJ4 



0J5 



HF2££BEOJ5 



BE0J4 



£.tBE0J5 



40400200 885E00 
000087C8 C6F25B 
E4D4D7C2 02008Aft 



B8EEOO0O 8 7C000 00 87C.8: 




C2Z 6u^) ^^< 

)0087CO P A. 






000087CO 
5B5BC2D6 

(rz) 



.HF2 



PEN 



.HF2 l(I£BDMPBC.. 



F2E,!1BE0J 

CCBE0J5 ...M.... 

HF2£{:BE 

F2&(lBEaj4 

...M HF2£<: 

.HF2SeBEOJ5 ...M 

4 HF2 

...HF2C&BE0J4 .. 

0J5 ...M H 

HF2eEBEOJ7 

BEOJ 

HF2(I£BDUM 

£6BDUMPB. 



....HF2 |££B0 



5bbBL2C3 
12C2O0O0 
C6F25B5B 
020089EE 
87C8C6F2 
E5F1020B 
000087C8 
03D5E2F2 
87COOOO0 
C2C3D3D6 
000087C0 
5B5BC2D6 
89EEO0OO 
C6F25B5B 



D3D6E2C5 
87C00000 
C2D5D7C9 
000087C0 
5B5BC2D6 
315A000n 
C6F25B5b 
020089CE 
87C8C6F2 
E2C50200 
003087C8 
07C9C7D5 
87C00000 
C2D607C5 



O2OO8A90 
87C8C6F2 
C7D50400 
O0O087C8 
D7C5D5F1 
87COO000 
C2C3D3D6 
O0OO87C0 
5B5BC2C3 
8A90000a 
C6F25B5B 
04008946 
87C8C6F2 
D5F10200 



LBLTYP HEX LENGTH IS 0000 



061000 
091020 
OBI 040 



^7C8C1E2 C55C5C5C 074D3000 000B1718 
D7C8:iE2 A00B16EE 000B32A8 OOOOOOIB 
00000330 OOOOOOOO OOOOOOOO OOOOOOOO 



D3D6E2F3 
87COOO0O 

000087C0 0C0087C8 C6F25B5B C2D6D7C5 

5B5BC2D6 D7C5D5F1 02008862 000087CO 

89460000 87C00000 87C0C6F2 5B5BC2D5 

C6F25B5B C2D6D7C5 05400200 89220000 

02008862 000087CO 000087C8 C6F25B5B 

87C8C6F2 5B5BC2C3 D4E3F0F1 02008,986 

E2C5020B 17C20000 87C00000 87C8C6F2 

000087C8 C6F25B5B C2C3D3D6 E2F3O20O 

04E3F0F5 02008882 000087C0 000087C8 

87CO0O00 87C8C6F2 5B5BC2D5 D7C5D540 

r,2D6D7C5 D5F10200 88620000 87COOO0O 

000037CO 000087C0 C6F25B5B C2D6D4&3 

5B5BC2D6 07C5D540 02008922 000087CO 

88620000 87C00000 87C8C6F2 OOOOOOOO 



OOOOOOOO OOOOOOOO 403B107A 00032O7A 
000B1910 00000049 00003002 0000002E 
00008450 5E0E6CAF OOOOOOOO OOOOOOOO 



F2£6B0PEN1. 

,HF2££B0PIGN F2&& 

.HF2£&B0PEN .... 

Nl HF2 

....F2C&B0UR01.. 

LOSE H 

HF2££BCL0S3 

3CMT05 

HF2££B0PE 

££B0PEN1 

F2££B0 

F26£BOPEN 



BOHT05 

HF2££B0PE 

££B3PIGN 

HF2££BC 

F2££BCL3S2 

....< HF2££ 

.HF2££BCL0SE.... 

N ...B HF2 

...HF2££B0PI6N.. 
HT05 ,....H 



.HF2££B0PEN1 HF2££ 

.HF2££BCMT0l.... 

SE...B HF2 

...HF2££BCLQS3.. 

MT05.. H 

HF2e£B0PEN 

BOPENl 

F2££B0MT 

££80PEN 

HF2.... 



BCEOtri 

HF2££BCL0 

££6:lOS2 

.K HF2££BC 

F2££BCL0SE 

...< HF2££ 

.HF2££B0PIGN.... 

05 HF2 

...HF2££B0PEN1.. 



PHASE***. 
PHAS 



m. l 



i 



An example showing the PD area in a system dump after executing the F/L trace 
in core-wrap output mode in the PD area. 
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Trace Routines 

PDAIDS 



Generalized Supervisor Call trace 

The GSVC trace records SVC interrupts as they occur. All SVCs, or a selected 
group of SVCs, may be traced. The format of the data recorded in the PD area 
either in a trace table or, when using the core -wrap output mode, in a rotating 
buffer, is as follows: 



^ 



Length of one entry = 1 8 decimal bytes 



III 1 1 1 1 

SVCOLDPSW 
ill 1 . i 1 


1 1 1 

GR© 
1 1 1 


SVC 
l\b. 


1 1 
GR1 

1 1 


SYSLOG 
ID* 



■+► AR 
BG 
F4 
F3 
F2 
F1 



See note 5 



The contents of general purpose register 1 



Value of the Supervisor Call, (See note 3.) 



The contents of general purpose register 0. 



Notes: 

1. IfPTO=YES in the FOPT macro, then SVCs issued when the physical 
transient area is busy are not traced. 

2. The PSW is described in E-2 of this Section. 

3. A list of DOS I VS SVCs can be found in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in appendix B. 



G 



l^> 

x.^' 



2.48 Serviceability Aids. 
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Trace Routines 

On the occurrence of an event, an entry is generated. By selection of the trace PDA IDS 

output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When the magnetic tape output is used, the tape must be processed by the 
PDLIST utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The GSVC function provides the following options: 

• Trace all SVCs that occur. 

• Trace up to six SVCs selectively. 

• Eliminate up to six SVCs selectively, and trace all others. 

• Trace all partitions. 

• Trace up to five partitions selectively. 

SVC limiting options are specified by the initializer keywords IGNORE SVC= 
or TRACE SVC=. All SVC activity is traced if one of these option keywords is 
not specified. The two keywords are mutually exclusive: when one is specified, 
the other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION=. This is useful only when the user must run several partitions at 
once, and does not wish to trace all of them. 

When reading the output from this trace routine you may see more SVCs listed 
than expected. This is because an SVC already traced and recorded may be reset by 
the supervisor SVC routine, and then re-issued by the program being traced. For 
example, your program may issue an SVC 0, which is traced. But the channel 
queue may be full at that point in time, and so the supervisor can not handle the 
SVC 0. When your program has control again it will issue the SVC which will of 
course be traced again. 

When to use: Use the GSVC trace when a particular SVC issued by a troublesome 
program is suspected of causing the errors. 

The values of registers and 1 are printed on the trace output and these can be 
important for certain SVCs. 

The trace output also shows the current PSW at the time the SVC was issued. 
Therefore, the instruction and routine issuing the SVC in the program can be 
located. 

The next two examples show the output obtained from a GSVC trace. 
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II ASSGN SYS005,X<2A1 
// MTC REW,SYS005 
// EXEC PDLIST 



SVC M fsw 



9^!^ 



Svco 

PSW-t0700l0000000 832i|'^0-|000092COll-^0092CO|^^0^^;;B$)|pSW-071D2000000»OB'VA 0-00040B't'» 1-000*1508 N-02 T-BG 



PSW-070D10000000831C 0-000<jOB44 1-000004AO N-21 T-BG PSH-070D000000008*84 O-OOOAOBA* 1-000*1*88 N-IA T-BG 

PSW-070D0000000084D6 0-000*08** 1-000082E8 N-02 T-BG | PSW-070D00000000830* 0-000*0B** 1-00000*A0 N-21 T-BG I 

PSH-070000000000B*22 0-000*OB** 1-00000*AO N-OB T-BG PSW-071D2000000*OB*C 0-000*08** 1-000*1*88 N-OE T-BG 

PSW-O70DOO0O000082FC 0-000*08** 1-00000*AO N-21 T-BG PSH-070000000000837C 0-000*06** 1-000082E8 N-02 T-BG 

PSM-0700000000008306 0-000*OB** 1-00000*AO N-21 T-BG PSM-070D2C0000008*BA 0-000*08*0 1-000082E8 N-02 T-BG 






An example showing a GSVC trace output as printed on a line printer using PDLIST. 
(A tape unit was selected as output device for the PDAID.) 



03F980 
03F9A0 
03F9C0 
03F9E0 
03FA00 
03FA20 
03FA40 
03FA60 
03FA80 
03FAA0 
03FAC0 
O3FAE0 
O3FBO0 
03FB20 
03FB*0 
03FB60 
03FB80 
03FBA0 
03FBC0 
03FBE0 
O3FC00 
03FC20 
03FC*0 
03FC60 
03FC80 
03FCA0 
03FCCO 
03FCE0 
03F000 
03FD20 
03FD*0 
03FD60 
03F080 
03F0A0 
03FDC0 
03F0E0 
03FE00 
03FE20 
03FE*0 
03FE60 
03FE80 
03FEAO 

03FEE0 
03FF0O 
03FF20 
03FF40 
03FF60 
03FF80 
03FFA0 
03FFCO 
03FFE0 



TERMTOHS 

22560000 
0000000* 
C2C70710 
000*0808 
000*0CA9 
000*22EE 
071D3000 
0910C2C7 
000B070* 
220C0000 
0000000* 
C2C7071D 
070*0808 
000*OCA9 
000*2256 
071DOOOO 
0820C2C7 
OCA9000* 
22C*0000 
0000000* 
C2C7071D 
000*0910 
000000 IB 
000*22EE 
07100000 
08D8C2C7 
OCA9000* 
22*C0OO* 
3000000* 
C2C7071D 
070*0910 
OOOOOOOB 
0OO*22C* 
O71DO0OO 
0910C2C7 
OOIBOOO* 
22560000 
0000000* 
C2C7071D 
000*0808 
000*OCA9 
000*22EE 
0:;iO3O00 
0910CZC7 
000B070* 
22OCO00O 
0000000* 
C2C7071D 
070*0808 
000*0CA9 
000*201 A 
00000000 



0018070* 
2256000* 
0000000* 
C2C70710 
000*0910 
OOOOOOOB 
000*2202 
07103000 
0910C2C7 
OOCB070* 
22E80000 
3000000* 
C2C7071D 
070*0808 
000*0CA9 
000*2256 
07100000 
0910C2C7 
OO0BO7O* 
22OCOOO0 
0000000* 
C2C7071D 
000*0910 
OOOOOOIB 
000*2256 
07100000 
08D8C2C7 
OCA 90 00* 
2202000* 
3000000* 
C2C70710 
070*0910 
OOOOOOOB 
000*2200 
O71D0OOO 
0910C2C7 
001B070* 
2256000* 
0000000* 
C2C70710 
000*0910 
OOOOOOOB 
-00042^! 02 
071D3000 
0910C2C7 
0O0B070* 
22 E 80000 
3000000* 
C2C7071D 
070*0808 
000*0CA9 
00000000 
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08D8C2C7 
0CA9070* 
2256000* 
0000000* 
C2C70710 
000*0910 
OOOOOOOB 
000*22EE 



07101000 
08D8C2C7 
0CA9070* 
2256000* 
0000000* 
C2C7071D 
000*0910 
OOOOOOOB 



tfSVC ^a^jt (m d^ ^■a^'^^^^^ti) ^n <af<,-£i>H^ page 12 



000*22*C 000*OCA9 000*0808 C2C70710 
07101000 000*22*C 000*OCA9 000*0808 
08D8C2C7 07101000 000*22*C 000*OCA9 
0CA907O* 0808C2C7 0710300*^ "•"•'-^ — 
22OC00O* 0CA9070* 0910C2C ^«e <J««<^ 
0000000* 22C*0000 000B07C/ ^- 

C2C70710 0000000* 220COOC^ Vn*^ 
000*0910 C2C70710 fi^nQff^^ 22C*Ob00 



07103000 000*2202 



2; 



Sv/C o^fSW 



C2C70flU 

070*0808 

0OO*0CA9 

000*201A 

07103000 

0910C2C7 

0O0B070* 

22C*0000 

0000000* 

C2C70710 

000*0910 

00000018 

000*2256 

07100000 

08D8C2C7 

0CA9000' 

22EE0000' 

3000000* 

C2C 70710 

070*0910 

OOOOOOOB 

000*2 2E 8 

07103000 

08D8C2C7 

0CA9070* 

2256000* 

0000000* 

C2C70710 

000*0910 

OOOOOOOB 

000*22EE 

07103000 

0910C2C7 

001B070* 

22*C0000 

1000000* 

C2C7071D 

070*0820 

00000000 






luuuuuu* 
C2C70710 
070*0808 
000*0CA9 
000*22EE 
07103000 
0910C2C7 
OOOB070* 
22OC0000 
0000000* 
C2C7071D 
070*0808 
000*0CA9 
000*2256 



OOOIB 000*0910 
*2256 OOOOOOIB 
SySLOq TO 00000 000*2256 
i:i'n,uuu"». uva^uuuf uod8C2C7 07100000 
0000000* 22*C000* OCA9000* 0808C2C7 
C2C7071D 0000000* 2010000* 0CA9000* 
070*0820 C2C7071D 3000000* 2202000* 
OOOOOOOB 000*0910 C2C7071D 0000000* 
000*2202 OOOOOOOB 000*0910 C2C7071D 
07103000 000*22EE OOOOOOOB 000*0910 
0910C2C7 07103000 000*2202 OOOOOOOB 
000B070* 0910C2C7 07103000 000*22EE 
22E80000 001B070* 0910C2C7 071D3000 
3000000* 22*00000 OOIBOOO* 08080207 
02C70710 1000000* 22*0000* OCA9000* 
070*0808 C2C7071D 1000000* 22*0000* 
000*0CA9 070*0808 MC7071D 10000 00* 
000*2256 000*OCA9 (070*0808 C2C7| )71D 
07100" " 



.QB6. 
...QBG. 



.B6 K. 



.«««..aB6 



.QBG... 

.QBG. 



22020000 0008000" '^''^^ ^f^<"«^'**^^= '^ S{/C ^ ' 

3000000* 22EE000( « V V 

C207071D 3000000* 22020000 OOOBOOO* 091.0T;2C7 

070*0910 02070710 3000000* 22EEO000 OOIBOOO* 

OOOOOOIB 070*0910 02070710 3000000* 22EE00OO 

000*22*0 OOOOOOIB 000*0808 02070710 0000000* 

07100000 000*22*0 000*00A9 000*0808 0207071D 

08080207 07101000 0O0*22*C 000*OOA9 000*0808 

0CA9070* 08080207 071D1000 000*22*0 000*0CA9 

2256000* 0CA9070* 0808C2C7 07103000 000*2202 

0000000* 220C000* 0CA9070* 0910C2C7 07103000 

C2C7071D 0000000* 22C*0000 0OOBO70* 09100207 

000*0910 -C2C70710 OOOOOOO*- 22DC0000 000B07O* 

OOOOOOOB 000*0910 02070710 0000000* 220*0000 

000*2202 OOOOOOOB 000*0910 02C7071D 0000000* 

07103000 000*22EE OOOOOOIB 000*0910 02070710 

09100207 07103000 000*22EE OOOOOOIB 000*0910 

OOIBOOO* 08080207 07100000 000*2256 OOOOOOIB 

22*0000* OCA9000* 08080207 07100000 000*2256 

0000000* 2010000* 0CA9000* 08200207 07100000 

02070710 0000000* 22*0000* 0CA9OOO* 08D8C207 

00000000 00000000 



...BG 

.QBG. 



Iqbc) /Jf' ^ 

'!:i;G:::::: ::::r^ ^-^ ^^ ^^J 

BG \^ /f/C 




An example showing a GSVC trace in core-wrap output in an alternate area. The 
alternate area is dumped on termination of PDAID and is given back to the main 
page pool. (The beginning of the alternate area is not shown). 



\J 
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QTAM Trace 



Trace Routines 

PDAIDS 



If 



This trace records the sequence of SIO instructions issued to channels and devices. 
The data recorded is similar to that of the I/O trace, but gives more details about 
the type of I/O interrupt. 

This routine is designed to trace programs running in real mode. However, it can be 
used to trace virtual mode programs provided the following is considered when 
reading the trace output: 

• If the program being traced is running in real mode the CCB address and the 
CCW address in the CSW are real addresses. 

• If the program being traced is running in virtual mode, the CCB address and 
the CCW address in the CSW are, respectively, the address of the CCB copy 
block. (Refer to Section 4 Chapter 13 for a description of CCB and CCW 
copy blocks.) 

There are three types of trace events and each type is recorded, having a prefix 
that defines the type. 

The data is recorded in the PD area, either in a trace table or, when using the 
core-wrap mode of output, in a rotating buffer. The format of the data recorded 
is as follows: 






• On the occurrence of an SVC interrupt; 



SVC 
No. 



1 I I I i r 

SVC OLD PSW 
J I ! I ! _L 



Prefix V 
X'E5' 



GR0 
J I 



1 — I — r 

GR1 
J I L 



Value of the Supervisor Call (See note 2.) 



ISYSLOq 
ID 



AR 
BG 
F4 
F3 
F2 
F1 



- (See note 5.) 



■ General purpose register 1 
General purpose register 



(See note 4) 



• On the occurrence of an SIO instruction 



1 i — 

CSW 



-1 — r 



I I I 



\ i i 1 

FF FF FF FF FF 
__l L_J L_ 



Device 
Addr 



CCB ADDR 
_J I L_ 



J L 



Prefix S 
X'E3' 



Condition code 



Not used 



o 



On the occurrence of an I/O interrupt; 



Device 
Addr 



T — I — I — r- 

1/0 OLD PSW 
J I I l_ 



1 I i I r 

CSW 
I I I I L 



Prefix I 
X'C9' 



FF FF 
l__ 



Not used 



Notes: 

1. The PSW and CSW is described in E-2 of this Section. 

2. A list ofDOS/VSSVCs can be found in Section 4. 

3. The CCB is described in Section 4. 

4. General purpose register usage is described in Section 4 

5. The S YSLOG ID is described in appendix B. 

Any of these occurrences is referred to as an event. On the occurrence of an 
event, an entry is generated. 
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By the selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The QTAM trace function provides the following options: 

• Trace all SVC and 3 1 , SIO , and t/0 interrupts . 

• Trace SVC and 31 , SIO, and I/O interrupts from any three devices. 

• Ignore SVC and 31 , SIO, and I/O interrupts from and three devices. 

• Trace in all partitions 

• Selectively trace up to five partitions. 

Trace Hmiting options are specified by the initializer message parameters 
IGNORE DEVICE^ or TRACE DEVICE=. (The device options are invoked by 
specifying the three devices to be traced or ignored.) All SVC and 31 , SIO, 
and I/O interrupt activity is traced in all partitions of core if one of these 
options is not specified. They are mutually exclusive: when one is specified, the 
other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION=. 

When to use: Use the QTAM trace to check the sequence of SIO instructions 
to the channels and devices. Use this trace if you suspect errors in I/O interrupt 
handling routines or in program routines issuing SVC and SVC 31 , or if you 
suspect errors in the sequence of I/O interrupts being returned from channels 
or devices. The next two illustrations are examples of output from a QTAM 
trace. 

The next example shows a dump of the real address area containing trace output 
when the core-wrap output mode in an alternate area is selected. 



if i\ 
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TERHKEN 



12/06/73 



GR 0-7 80040B0C 00041500 0003F800 00000000 

GR 8-F B00400A4 900*1086 00000000 182F07FI 

FP REG 00000000 00000000 00000000 00000000 

CR 0-7 OO'fOOOFF 00OOE64O FFFFFFFF FFFFFFFF 

CR 8-F OOOOFFFF 00000000 00000000 00000000 



00000050 00041084 00042084 00040FB8 
00040078 40040084 0003FFF5 08041518 
00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 
00000000 00000000 C2000000 00000200 






03F800 
03F820 
03F840 
03F860 
03F880 
03F8A0 
03F8C0 
03F8E0 
03F900 
03F920 
03F940 
03F960 
03F980 
03F9A0 
03F9C0 
03F9E0 
00- 



if 



03FA. 



o 



= A20 
03FA40 
03FA60 
03FA80 
03FAA0 
03FACO 
03FAE0 
03FB0O 
03FB20 
03FB40 
03FB60 
03FB80 
03FBA0 
O3FBC0 
03FBE0 
03FC00 
03FC20 
03FC40 
03FC60 
03FC80 
03FCA0 
03FCC0 
03FCE0 
03FD00 
03FD20 
03FD40 
03F060 
03FD80 
03FDAO 
03FDC0 
03FDE0 



FDOCOOOO 
0130070F 
04000000 
09070F20 
OOOOOOFF 
070F20OO 
OOOOFFFF 
OF200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A01000E7 
00FFFFC9 
JlQflOOaOO 



0F200000 
OOfFPFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090C00 
FFFFC900 
090COOOO 
FFC90009 
OCOOOOOO 
C9000907 
60084000 
0130070F 
04000000 



00090C00 

FFFFC401 

090C000O 
FFC90130 
OCOOOOOO 
C9000907 
00000000 
00090 70F 
00000004 
09070F20 
00000400 
070F2000 
00040000 
OF200000 
50FFFFFF 
20000000 
FFFFFFFF 



003AF00C 
30070C20 
00000400 
070F2000 
00040000 
OF200000 
04000000 
20000000 
OOOOOOFF 
00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFC901 
090C0O00 
FFC90130 



OOOOOOFF 



00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFE200 
090C1000 
FFE20000 
OC 1000 76 
E2 000009 
100076C8 
00000900 
00E76008 
30070C20 
00000400 
070F2000 



FF^20001 
0CO00O3A 
E2000130 
000087AO 
00000900 
0078D008 
00090000 
79380800 
09000076 
60080000 
000076C8 
08400000 
00E5C80O 
400050FF 
00000009 
OOOOFFFF 
000009 OC 



FFF 

09octrooo 

FFE20001 
OC 00008 7 
C9013007 
00000000 
0009070F 
O03AF0OC 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
000039AO 
08000000 
0039AOOO 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
000087AO 
FFFFC901 
00000004 
FFE20001 
OC000087 
E20002A2 
0O0OE838 
O130070F 
OCOOOOOO 
01300000 
3AF00C00 



01300000 
3AC00800 
30000039 
AOOCOOOO 
OC200000 
04000000 
20000000 
OOOOOOFF 
00000009 
FFFFfFFF 
0000090C 
FFFFFFC9 
000087A0 
FFFFC901 
00000004 
FFE20001 
0C00003A 
C9013007 
OOOOOOOO 
0130070F 
OCOOOOOO 
30070F20 
OOOOOOFF 
30000039 
AOOCOOOO 
0000E6C8 
0C000012 
20000000 
FFFFFFFF 
39A00000 
OOOOFFFF 



AOOOOOOO 
00FFFFE2 
00090C00 
FFFFE200 
090COOOO 
FFE20001 
0C00003A 
C9013007 
OOOOOOOO 
01300 70F 
OCOOOOOO 
30070F20 
OOOOOOFF 
30000039 
FOOCOOOO 
OC200000 
04000000 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
AOOOOOM. 

OOFFFlfyJj 

000087TO\ 

FFFFE200 

O90C0000 

FFC90130 

87A00C00 

E2000130 



3AF00C00 
C9013007 
00040000 
00013000 
003AC008 
01300000 
00000400 
30000039 
FOOCOOOO 
0C2 00000 
04000000 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
00090COO 
FFFFE200 
O9OCO000 
FFC 90130 
OCOOOOOO 
C9013007 



OOOOFFFF FFFFFFt:9 



0F2O0O0O 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A0000O 
OOOOFFFF 
A000003A 
0OFFFFE2 
00090COO 
FFFFE200 
090C0000 
FFC90130 
OCOOOOOO 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87AOOCO0 
070C2000 
00040000 
0F2OO000 
OOFFFFFF* 



00090COO 
FFFFC901 
0087AOOC 
FFC90130 
00000400 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87A0OC0O 
070C2000 
00040000 
OF200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A0O0OO 
OOOOFFFF 
0000090C 
0OFFFFE2 
00090C00 
•FP*^C90l 



30000039 
C0080000 
000039AO 
OCOOOOOO 
0078D000 
OOOOOOFF 
79380000 
OOOOFFFF 
60000000 
00FFFFC9 
OOOOOOOO 
FFFFC900 
00000004 
FFE20001 
0C0OOO3A 
E2000130 
00003AF0 
0130070C 
00000004 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
OF200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39AOOOO0 
OOOOFFFF 
0000090C 
00FFFFE2 
00090COO 
FFFFC901 
003AFOOC 
FFC90130 
00000400 
E2000130 
00003ACO 
00013000 
003AF00C 
30070F20 



A000003A 
O0FFFFC9 
OOOOOOOO 
FFFFC900 
00000004 
FFC90009 
00000400 
C9000907 
00040000 
0009070F 
04000000 
09070F20 
OOOOOOFF 
30000039 
C0080000 
000039AO 
OCOOOOOO 
20000000 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090COO 
FFFFC901 
003AFOOC 
FFC90130 
00000400 
E2000130 
00003AC0 
00013000 
0O3AF0OC 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
0O0039A0 
08000000 
0O39A0OO 
OOOOOOFF 
OOOOC 



OOOOOOOO 



■svco 



9y^/2i 



SVC <^/>S^ 



^e ettuy^ 



Sysuoa zj) 






o^ 2/r. 




03FE00 
03FE20 
03FE40 
03FE60 
03FE80 
03FEA0 
03FECO 
03FEEO 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
03FFAO 
03FFC0 
03FFE0 



TERMKEN 

070F2000 
OOOOFFFF 
000039AO 
OCOOOOOO 
OOE6C800 
OOOOOIFF 
E6C81000 
OOOIFFFF 
C81000E7 
01FFFFE2 
0009 OCOO 
FFFFC901 
003AF00C 
FFCZOOOl 
0C00003A 
OOOOOOOO 



0000090C 
FFFFFFC9 
00003AFO 
FFFFE500 
0087A00C 
FFE50000 
E8380C00 
E5O0O007 
60OC000O 
00013000 
003AFOOC 
30070F20 
OOOOOOFF 
30000039 
FOOCOOOO 
OOOOOOOO 



12/06/73 

000087AO 
0130070F 
OCOOOOOO 
00071000 
OOOOOOFF 
071D0000 
OOOIFFFF 
IDOOOOOO 
OlFFFFFF 
0039A010 
OOOOOOFF 
00000009 
FFFFFFFF 
A00OO03A 
00FFFFE2 
OOOOOOOO 



OCOOOOOO 
20000000 
FFFFFFFF 
00000415 
FFFFFFFF 
00041542 
FFFFFFC9 
041542A0 
FFFFC902 
00E8380C 
FFE20001 
OC00003A 
C9013007 
FOOCOOOO 
00013000 
OOOOOOOO 



FFFFE200 
090COOOO 
FFC90130 
42A00410 
C902A207 
A004106C 
02A2070F 
04106C00 
A2070F20 
OOOOOIFF 
30000039 
FOOCOOOO 
0F200000 
OOFFFFFF 
0039A000 
OOOOOOOO 



01300000 
3AF00C00 
070F2000 
6C000414 
OF200000 
00041488 
20000000 
041488C2 
00000009 
FFFFFFFF 
A000003A 
00FFFFE2 
00090COO 
FFFFC901 
O03AFO0C 
OOOOOOOO 



39A00OOO 
OOOOFFFF 
0000090C 
88C2C7E2 
00090C10 
C2C7E200 
090C1000 
C7E20002 
0C1O00E8 
C9013007 
FOOCOOOO 
00013000 
003AFOOC 
30O7OF20 
OOOOOOFF 



87A00C00 
E2000130 
000087A0 
0002A200 
00E8380C 
02A20000 
E7600C00 
A20000E6 
380C000O 
OF200000 
OOFFFFFF 
0039AOOO 
OOOOOOFF 
00000009 
FFFFFFFF 



..,,... I,, o « 


0. 





.1 




























....v.... 




.,,,BGS.....II 


H..X- 

...s 


...v.. 




v.... 

I 
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An example showing a dump of the alternate area used for a QTAM trace in core- 
wrap output mode. 
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01S900 
016920 
01S9'fO 
01S960 
016980 
015940 
0169:0 
01S9E0 
O15A0O 
016420 
0164*0 
016460 
016480 
Ol')440 
0164CO 
016AE0 
016B00 
016B20 
016840 
016860 
016880 
016840 
0166CO 
0168EO 
O16C0O 
015FE0 

-P.O.- 
009480 
009440 
0094C0 
0094E0 
009500 
009520 
009 540 
009560 
009580 
009 54 
0095C0 
0095=0 
009600 
009620 
009640 
0')9660 
009680 
009 64 
0096C0 
0096E0 
009 700 
009720 
009 740 
0099CO 

LBLTYP 

— =(r,— 

04DO0O 
040020 
040040 
040060 
040180 
0400AO 



OOOOOOOE 
831 0:2:7 

eEEEoi:8 

OOOOD008 
00000300 
00020DOO 
8310:2:7 
EEEE0i:8 
00000008 
00000300 
00020007 
0000333E 
OOOOOOOE 
EEEE0166 
EEEE0134 
87878787 
00000007 
000002:8 
EEEE0195 
EFEE0134 
87873787 
00000007 
000002:0 
80008420 
00003330 
00000000 

AREA 

00003300 

FFFFFP=F 

FFFFF=30r 

078Ai'<00 

90BC42:0 

91010734 

58700014 

402 091)2 

92FF8010 

91023334 

91765880 

00805330 

91C44138 

00006 360 

00042334 

9087934: 

47F 09246 

49509333 

95FF903C 

4C709232 

415091)4 

00000330 

00000303 



0000F728 08000000 0000F718 

80006690 71005700 200E2880 

470DO0OO 00008AB5 00081010 

0001 54C0 O00OB7OA 00000030 

80008860 A0008944 O00O87C0 

00000007 00008B50 00000017 

80006690 71005700 200E2880 

470DOOOO 00008AB6 00081010 

000164E0 000087DA 00000030 

80008660 A0008944 000087C3 

00000007 d0008B60 00000017 

00000000 04000000 0300F713 

00000000 04000000 0000F7AB 

070C2000 00000952 00001013 

040C2000 000009BC 00001013 

80808080 80838080 80808033 

00008B60 00000017 03008848 

00040000 00003AB4 000004A0 

47000000 00008AB6 OOOBIOIO 

040C2000 000009BC 00001013 

80808080 80838080 80808083 

00008850 00000015 00006848 

00040000 00303AB4 000004A0 

000004A0 000087CO 000087C0 

00000000 ^/'^ ^jf^ °f 

Ei30O99FF 0000479C 

00004796 00003AB» 000313)3 
?OOO3F6O0(|OO03FFF5k 3FDEFFFF 



EEEE31B4 
87678737 
00000007 
00000200 
EEEE0196 
EEEE31B4 
87878787 
00003007 
000002:8 
EEEE0195 
EEEE0166 
EEEE31DC 
FFOOF640 
OOOOOOOE 
8310C2C7 
EEEE01C8 
00003038 
00003000 
000;',3000 
831JC2C7 
EEEE01C8 
00000008 
00003300 
00000000 



040C2000 
80808080 
00008B60 
00040000 
47000000 
040C2000 
80808080 
00008B60 
00040000 
470DOOOO 
070F2000 
040COOOO 
OOOOOOOE 
OO00F7B8 
80006690 
47000000 
000164EO 
83008853 
00000007 
80006590 
470DOOOO 
00016500 
80008860 
00000000 



003009BC 
80836080 
00000016 
00003AB4 
00008AB6 
003009BC 
80838080 
00000017 
00303AB4 
00008ACO 
00000962 
0000168E 
00003FFO 
08003000 
71006700 
00003AB6 
0OO037DA 
A0006944 
00006B60 
71005700 
00008A86 
300087DA 
90008944 
00000000 



00001010 
80838080 
00008648 
O0a0O4A0 
00081010 
00001010 
60808080 
00008648 
003004AO 
00081010 
00001010 
00031010 
080060C6 
0003 F7A8 
200E2860 
00081010 
00000030 
000087CO 
0000 0015 
200E2880 
00381010 
00030030 
000087C3 
00000000 



00 00000000 00000000 00000000 






91C492C9 
B01C9200 
00155980 
00009486 
00041020 
9180905B 
0203913C 
47809156 
47809298 
43709232 
58690000 
— SAME — 
00000000 



8000D201 
91579878 
91:84740 
OOO3F8C0 
909F9048 
4710920A 
922647F0 
4930903A 
5850903C 
1A755050 
47F0926E 



800100BA 
91B6D502 
91AA5683 
0003FFCB 
02039345 
D2119144 
924648B3 
077A953) 
58609043 
91C05053 
58B091C) 



000015BE 0000B44E 00000C55 
r27:*ClC9 C4D3E3E6 FFFF3309 



207 
)78 

^JiOJ/Oft HVDUVU:5A UfaAH700 

D20F8003 003892FF 601392FF 

B03391CC 078AD501 B00691CF 

9i:05380 91C49878 91B807FA 

0303FFE0 C4E4D4D5 E710300E 

9049D233 934B9344 32009381 

923495FF 903A4770 921C3201 

91D29155 906COOOO 00000015 

939F*77) 92540231 90969295 

02339054 90401B55 16761B56 

91:45373 91C89857 91D447F0 

92FFB330 D213B001 B00047FO 



00009F02 
FFFFFFF= 
0003FFF5 
44039186 
B0454770 
078A95FF 
9001 BOOB 
41110000 
8008 0040 
91B80201 
91554700 
801458B0 
07645863 
00000000 
0O00OC55 
90430200 
913E922A 
47809156 
90579134 
50609230 
9244A000 
905:0000 



00000000 00003333 00300000 00330000 00000000 00000000 



HEX LENGTH IS 0000 

37;8;i!2 :55C5C5C 071D2000 000433C5 

07C8:iE2 B004009E 00040620 00000000 

7F0B394E 80000015 00088FFF 900421F5 

00000000 00000000 00000000 00000000 

58103536 58F10010 45EF300: 024FB13E 

65845330 B58E0A12 5810BS92 5C00B596 



00003030 00300000 40343074 OO04OO7B 

00D2F000 00088FFF 00000000 00000000 

30308450 5705A7E4 00003000 00030000 

00003000 00030000 05a0024F B18E84AE 

B4FE5313 B58656FI 301345EF 000:5813 

0A3A1B99 1.2334780 BO460630 47F0B03A 






. #. .0 

...DUMNX 

• K K K. 



,»#..#« .D#..H...M.O. 



PHASE*** 

PHAS KO 

...t 6 ...#...U. 



.0.. C2'/t) 



The example above shows part of a system dump output. By examination of the 
PDAREA printed in the dump (when PDA ID is supported by the system) it can 
be seen that a QTAM trace was active when the dump was executed. From the 
PDAID phase name in the PD area, the output mode for the trace was core-wrap. 
However, no trace entries are seen in the PD area, which indicates that the an 
alternate area had been specified for the trace entries. The start address of the 
alternate area is contained at displacement decimal 20 from the start of the PD 
standard preface table. (The standard preface table starts at the PDAID 
phase name.) 
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OldBCO 
OlSBEO 
015COO 
OlSFEO 

-P.D.- 
009A80 
O39AA0 
0094CO 
0094E0 
009 500 
009 52 
009 540 
009560 
009580 
009 SAO 
0095CO 
0095E0 
009600 
009 620 
009640 
009660 
009680 
0096A0 
0095C0 
0096EO 
009 700 
009720 
009740 
009760 
009780 
C097A0 
009 7C0 
0097EO 
009800 
009 82 
009840 
009860 
009880 
009 SAO 
0O98CO 
C098E0 
009900 
009920 
009940 
009960 
009980 
0099A0 
C099C0 
009 9E0 

LBLTYP 

UOOO 



10/05/73 

000005A8 OOOBIOOO 00003AE4 00004360 
000Bn7A D7C8C1E2 e00B136C O00B32Ae 
00000000 —SAME — 
OOOOOOOO 00000000 00000000 00000000 






AREA 

OOOODOOO 
FFFFf=FFF 
FFFFFF30 
078A4400 
90BC42:o 
91D1078/. 
5870001' 
402 09132 
92FF8D10 
9102003A 
91765880 
008053B0 
91C44188 
00006360 
OF203D30 
OOFFFFFF 
2 0000030 
008B63;5 
F8C80000 
OOOOFFFF 
00003962 

ffffff:9 

008AB600 
FFFFE233 
09620030 
F2C9000E 
00000400 
E 5003047 
00003000 
OO0E073C 
00000700 
OOOE0330 
F9200800 
070F2030 
00040300 
OC200300 
00008360 
00F8C800 
OOOOOOFF 
00000339 
FFFFFFFF 
00008AB6 
00FFFFB8 



00004793 
FFFFFFFF 
FFFFFFFF 
918E078A 
91 01 95 FF 
907891 B8 
4870705A 
92E28000 
02038011 
47F09156 
91C492C9 
B01C9200 
00155980 
00009488 
00096200 
FFFFC900 
09620000 
F2C9000E 
00000400 
E500Q047 
OOOOOOOO 
0OOEO70C 
00000700 
OOOEOOOO 
F7B80800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B60C6 
F8C800O0 
OOOOFFFF 
00000962 
00FFFFE2 
00096200 
C6F2C90D 
00000004 
FFE50000 
62000000 
C9000E07 
00000007 
C6F25B01 



000099FF 
00003AE4 
FFFFFFFF 
47F090EC 
9500008B 
91D1078A 
588091C4 
1A7C02O1 
50180004 
80109430 
49B09036 
8000D201 
91579878 
91C84740 
0000965C 
00000004 
0E070C20 
F9200800 
O70F200O 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000962 
FFFFFFC9 
008AB600 
FFFFE200 
09620000 
F2C9300E 
00000400 
E5000047 
OOOOOOOO 
OOOOOEOO 
O0F92008 
0E070F20 
OOOOOOFF 
47000000 
00040000 
OC 2 00000 
00008B60 
D6C2C3E3 



0000479C 
00001033 
3FDEFFFF 
47F09132 
4780908E 
95FF91D1 
92E58000 
80137002 
40280002 
800192F0 
078A49BO 
800100BA 
91B8D502 
91AA5883 
0000993B 
OOOOOOFF 
00000009 
OOOOFFFF 
00000962 
FFFFFFC9 
008AB600 
FFFFE200 
09620003 
F2C9000E 
OD000400 
E5 000047 
OOOOOOOO 
O0OEO7OC 
00000700 
OOOEOOOO 
F7B80800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
OOF8C800 
OOOOOOFF 
00000009 
FFFFFFFF 
00008AB6 
O0FFFFE2 
00096200 
C6F2C900 
03C7040B 



00003000 80008860 90008944 OOO067C:O 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



0000168E 
D7;4C1C9 
FFFFFFFF 
470091D4 
951F008B 
078A95FF 
02018001 
47F0919A 
187A8870 
915747F0 
90380 78A 
020F8003 
B00391CC 
91C05080 
000099E3 
FFE20000 
62 000 OF 7 
C9000E07 
OOOOOOOO 
000E070C 
00000700 
OOOEOOOO 
F9200800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04003000 
20000000 
008B63C6 
F8C30000 
OOOOFFFF 
00000 962 
FFFFFFC9 
OOeAB600 
FFFFE200 
00000004 
FFE5000O 
62003000 
C9000E07 
00000007 
OOOOOEOO 
0OF92008 
OE070F20 
1958000B 



0000 B44E 
C4D3E3E6 
FFFFFFFF 
58B0OO8O 
077A58B0 
91D1078A 
008AD207 
907891B8 
00184278 
91 3C 9200 
49B0903A 
003892FF 
078AD501 
91C49878 
C4E4D4D5 
OEOOOOFB 
B8080000 
0F200000 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000962 

ffffff:9 

008AB600 
FFFFE200 
0962 0000 
F2C9000E 
00000400 
E5000047 
OOOOOOOO 
000e070: 
00000700 
OOOEOOOO 
OOOOOOFF 
47000000 
00040000 
OC200000 
00008B60 
OOF8C800 
OOOOOOFF 
00000009 
2888000B 



00000C56 
FFFF3009 
FFFFFFFF 
58B0B01C 
00809 500 
95FF91DI 
80030020 
588091C4 
0001D207 
91579078 
078A4700 
801392FF 
B0a631CF 
91B837FA 
E740000E 
:8003000 
00FFFFE5 
30095200 
FFFFE200 
09620000 
F2C9000E 
00000400 
=5003047 
OOOOOOOO 
O00E37OC 
00000700 
OOOEOOOO 
F9200800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B60C6 
F8C83000 
FFFFFFFF 
00008AB6 
00FFFFE2 
00096200 
:6F2:900 
00000004 
FFE50000 
62000000 
2888C6F2 



00009F02 
FFFFFFFF 
FFFFFFFF 
44009186 
B045 4770 
07BA95FF 
9001 800B 
41110000 
6008 0040 
91B8D201 
91554700 
80145880 
O78A5880 
OOOOOOOO 
C9O0OEO7 
OOOEOOOO 
00004700 
00030004 
OOOEOOOO 
F7B8O800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000962 
FFFFFFC9 
008«B600 
FFFFE200 
09620000 
F2C9000E 
00000400 
C9O0OEO7 
00300007 
OOOOOEOO 
O0F7B8O8 
OE07OF20 
OOOOOOFF 
47030000 
00040000 
OOOOOOOO 



V. •• ^ t .^ 

..U.«;>»(PDA IDQTW.J 



.J.. .J J J J. 

O.V.. K K 



.N N. 



...TDUMNX ..I. 
.S 8H 




....9 I. 



■•I -AV- 9- 



\W, 



'-W- 






.S 8H.>i 



-F2I 

.F2£jaBCTLG F2... 



HEX LENGTH IS 0000 
f07C8ClE2 C55C5C5C O74D0OOO 000B146E 



00000001 00000013 40081 07A 0OOB2O7A 



^^ J-u^cH^ FZ Aoh^^^^^^^ 



^i<tio€ ayett 






This example shows part of a system dump output that by examination of the PD 
area indicates QTAM trace entries in the PD area. Compare this example with the 
previous one and note the difference between the information contained in the 
PD area. 
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The PD area 

The PD area is located in the supervisor and consists of four separate parts 
described below and shown in 

1. PD Address Table 

This table is built up during system generation if the system is to support 
PDAIDS. It contains the addresses of the supervisor hooks that provide the 
interface between the PDAID routines and the supervisor. 

2. PD Standard Preface Table 

This table is built up by the PDAID initializing phase, and is used by the PDAID 
event handling routines. 

3. PDAID Event Handling Area 

This area is occupied by the PDAID event handUng routines specified by the 
type of trace requested by the operator. 

4. PD Buffer Area. 

This area is used in the following two ways: 

When core-wrap output mode in the PD area is specified it is used as a rotating 
buffer which preserves events (trace entries). PDAID event handling routines 
use this area as temporary storage for events. This storage area is called the 
trace table. Data is transferred from this table to an output area, which is either 
printed out or dumped on a tape unit, depending on the output device selected 
for the trace routine. 



Locating the PD area 

The start address of the PD area can be located by: 

1. Using any dump containing the supervisor area to find the address of SYSCOM 
(system communication region) in bytes 80 to 83 of low address storage. (See 
E-2 in this Section.) 

The address contained in bytes X'48' to '4B' (label PDARPTR) of SYSCOM 
contains the address of the PD area. 

2. Using the supervisor Hstings to find the address of the label PDAREA. This 
label is the name given to the first byte of the PD area. 

Dumping ttie PD area 

The easiest method is to use the PD AREA operand of the DUMP command. (See 
A-1 in this Section.) Alternatively, any dump of real storage that includes the 
supervisor area will also include the PD area. 



o 
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Page of GC33-5380-1, 
revised June 30, 1974, 
by TNL SN33-8780 
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Virtual Storage 

/ \ 
/ \ 



Label 

PD AREA 



LOW ADDRESS STORAGE 



SUPERVISOR 



PD AREA 



PAGE POOL 
unless it belongs 
toBGR 















PD Address Table 




PD Standard 
Preface Table 




PD Event 
Handling 
Routine area 




SL0T1 


NEXT 


wrapadr[ 




PD Buffer. 
Used for core-wrap 
output, or PDAID 
event handling. 



For details of 
contents, see 
Appendix A. 



X' 



7, 



PD buffer, when 
used as core-wrap 
y I output mode. 

/ 
/ 
/ 



'Last 12 bytes in PD 
Event Handling Area 



FIRST entry. 



NEXT entry. 



LAST entry. 



Note: 

See Section 4 for details about the supervisor organization. 



SLOT1 



NEXT 



WRAPADR 



Trace type. 



Contains address of 

FIRST entry in PD 

Buffer. 

it is found at: 



Contains address of 
NEXT available entry 
in PD Buffer. 
It is found at: 



Contains address of 

LAST entry in PD 

Buffer. 

It is found at: 



Length of one 
entry in bytes; 



IVIaximum number 
of entries in the 
minimum PD area 
of 1400 bytes (dec) 



Input/output 



PDAREA+ 1B4 



PDAREA + 1B8 



PDAREA + 1BC 



18 (dec) 



52 



Fetch/load 



PDAREA + E8 



PDAREA + EC 



PDAREA +F0 



22 (dec) 



52 



GSVC 



PDAREA+X'114' 



B = A +4 



C = A + 8 



18 (dec) 



61 



QTAM 



PDAREA + '100' 



B = A+4 



C = A + 8 



21 (dec) 



44 



Notes: 

1. NEXT - address of the next available entry in the PD Buffer. Tlie NEXT entry 
in the PD Buffer contains either the oldest entry in the tuble, or the most recent 
entry of a device, SVC, or partition being ignored (all entries are placed in the 
NEXT entry before they are checked for trace or ignore). If the latter is the case, 
ignore the entry. 



2. When the LAST entry is filled, the addrcos in SLOTl is loaded into NEXT and 
the buffer is overwritten by new entries. 



Table B-3 Trace entry locations and lengths for core-wrap output mode in the PD area. 



Serviceability Aids. 2.57 



Trace Routines 

PDAIDS 



Initiating the PDAID trace routines 

You can initiate PDAID trace routines by using standard DOS/VS job control 
languages from either SYSLOG or SYSIPT. The statement 

//EXEC PDAID 

causes the main phase (PDAID) to be loaded at the address of the initiating 
partition. Control is given to the PDAID for further specifications to indicate 
the type of trace to be performed. 

The options and control statements for the trace routines may be entered through 
SYSLOG or through the device assigned to SYSIPT. 

If a card reader is used as SYSIPT, the card deck must be punched as follows: 

Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. AH 80 columns of a 
card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last card must be followed by a /* CARD. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested on 
SYSLOG. 

When the initializing phase (PDAID) has been loaded, the following message is 
issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

IT Specifies an I/O Trace (See note 1 .) 

FT Specifies an F/L Trace (See note 1 .) 

GT Specifies a GSVC Trace (See note 1.) 

QT Specifies a QTAM Trace (See note 1 .) 

TD Specifies the Transient Dump 

(refer to A-4 in this Section) 

XX Terminates the PDAID presently running 

Pressing the END or ENTER key indicates that PDAID control statements are 
entered through SYSIPT (See note 2.) 

Notes: « 

1. When IT, FT, GT, or QT is specified, the operator must provide additional 
PDAID control statements through SYSLOG. 

2. The END response is valid only for SYSLOG and cannot be used as a SYSIPT 
operand. 

3. Multiple operands or operator responses to PDAID control statements for traces 
with a variable number of functions (such as ignoring SVCsJ are not allowed. 
Repeat each parameter with each variable). Repeat each message until either 
the maximum number of variables is reached or an END response is given. 

4. GO terminates the PDAID control input, and the default is taken for any 
PDAID options that are not specified. When you use SYSIPT, GO should be 
the last parameter, and it has no operand associated with it. A I* card must 
follow the GO operand. 
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Trace Routines 

Selecting the output mode P D A I D S 

Selection of an output device: 

The PDAID message/parameter OUTPUT DEVICE= permits the selection of an 
output device. Specify the device by channel and unit, not by symbolic unit. If an 
output device is specified, PDAID checks the address against the supervisor PUB 
and selects the appropriate phase for the unit type (tape or printer). If the output 
is to be magnetic tape, you must use the PDLIST program after tracing is 
complete to obtain a printout of the tape. 

Selection of core-wrap mode: If an output device is not specified, core-wrap mode 
is assumed. The event trace table (see Table B-3) is in the PD buffer in PD area. 
The number of events (trace entries), contained in this area depends on its size as 
generated at system generation time with the option of the FOPT macro. PD=YES 
or 1400 is the minimum, and 10,240 is the maximum that can be selected. 

The table shown in the previous illustration lists the maximum number of events 
that can be preserved in this area, for each of the four trace routines. If core-wrap 
mode is selected, an alternate area can be used. 
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Specifying an Alternate Area 

An alternate area may be specified for core-wrap output through the message/ 
parameter AAA= (alternate area address). AAA= and OUTPUT DEVICE= are 
mutually exclusive: when one is specified, the other cannot be used. The 
operator specifies an alternate area by responding to AAA= with nk. 

n should be an even integer but if an odd integer is specified, n+1 is assumed, 
n specifies the number of thousand (1024) bytes to be allocated to the alternate 
area, which is taken from the main page pool. 

After AAA=nk has been entered, one of four messages is printed on SYSLOG: 

1. If the requested size of the alternate area is accepted, the message is 
4C50E ADDRESS OF AAA= xxxxxx 

2. If space could not be allocated from the main page pool, the message is 

4C52E NO SPACE AVAILABLE FOR AAA. PDAID IS TERMINATED 

The size of the page pool must be increased and the PDAID must be 
re-initialized. 

3. If the space requested is larger than the space that can be allocated from the 
page pool, the message is 

4C51D SIZE OF AAA=nK, ADDRESS OF AAA=XXXXXX. END/CANCEL 

If the space allocated is sufficient, the operator need only press the END/ENTER key. 
However, if the space allocated is not sufficient, the operator must respond 
with CANCEL, and the size of the page pool must be increased before 
re-initializing the PDAID. 






4. If a second or duplicate request is made for an alternate area, or if a request is 
made for a PDAID using an alternate area while any SDAID function is running, 
the second request is automatically terminated, and the message is 4C70E 
4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 
The above message is also issued if a second or duplicate request is made for SDAIDS, 






Dumping the alternate area 

The contents of the alternate area is automatically dumped on the device assigned 
to SYSLST upon termination of the PDAID. (See "Terminating core-wrap in an 
alternate area" for details.) However, if a dump of an alternate area is required 
without terminating the PDAID, use the xxxxxx, xxxxxx operand of the DUMP 
command. (See A-1 in this Section for details.) 

Note: If this command is used, the trace output will include the fetch and execute 
of the DUMP transient. Specify the address of AAA in the first operand of the 
command, and calculate the value of the second operand from the value ofnk, 
given in the message 4C51D or specified in the message 4C27D during trace 
initialization. 

Use Table B-3 and the dump to locate the oldest and newest trace entries. 
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Trace Routines 

PDA ID error messages P D A I D S 

PDAID routines issue error messages on SYSLOG if incorrect or duplicate 
parameters are specified, or if selected output devices are not ready. The PDAID error 
messages together with recommended actions for operators and programmers are 
listed in the DOS /VS Messages manual. 

The following list is a table of options and control statements for executing the 
trace routines. The statements in the table are shown in the sequence in which 
they must be used. Five flowcharts follow the table of options. These flowcharts 
show how to execute the trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples 
of initiating via SYSLOG, immediately follow the last of those flowcharts. 
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PDAIDS 
Initializing PDAIDS 



SYS LOG 

Message 



SYSIPT 
Parameter 



PDAID = 



OUTPUT DEVICE 
(see note 3) 



AAA = 
(see note 3) 



TRACE PARTITION= 
(Valid for Fetch/Load, 
SVC, and QTAM Trace) 



IGNORE DEVICE 
(See notes 2 and 7) 



TRACE DEVICE' 
(See notes 2 and 7) 



IGNORE SVC = 
(See notes 2 and 7) 



TRACE SVC = 
(See notes 2 and 7) 



GO (Valid SYSIPT 
Parameter) 
(See note 4) 



SYS LOG 
Response 



SYSIPT 
Operand 



FT 

GT 

IT 

QT 

TD 

XX 

END 



cuu 
X'cuu' 
EN 
GO 



:uu 




SP 

BG 

F4 

F3 

F2 

F1 

END 

GO 



cuu 
X'cuu' 
END 
GO 



J_i 



cuu ~ 
X'cuu' 
END 
GO 





GO 
(Valid SYSLOG 
Response) 
(See note 4) 



Meaning 



FT - Fetch /Load Trace 
GT - GSVC Trace 
IT- I/O Trace 
QT - QTAM Trace 

TD — Transient Dump, refer to A-4 in this Section 
XX - Terminate present PDAID function. 
END - Additional PDAID control input through 
SYSIPT (See note 5) 



Specify the hexadecimal channel and unit number 
of either a magnetic tape unit or a printer for the 
output device of the PDAID. 
(see note 6) 



The parameter nK specifies the number of bytes to 
be allocated as alternate address area. This area will 
be allocated storage from the main page pool. The 
value n must be an even integer. If it is not an even 
integer, (n+1 ) K is allocated. 



SP - Supervisor 
BG -Background 
F4 - Foreground 4 
F3- Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 
(see note) 



Specify the hexadecimal channel and unit number 
of the device to be ignored by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Specify the hexadecimal channel and unit number 
of the device to be traced by the I/O and QTAM 
trace. A maximum of 3 may be specified. 



Specify the hexadecimal SVC number to be ignored 
by the GSVC trace. A maximum of 6 may be 
specified. 



Specify the hexadecimal SVC number to be traced 
by the GSVC trace. A maximum of 6 may be 
specified. 



GO terminates the PDAID control input and the 
default is used for those options that are not 
specified. 



Default 



None. 



Core-wrap mode. 
(See note 7) 



Core-wrap 
mode using 
PD area 



Trace all partitions and 
the supervisor. 



Trace all devices. 



Trace all devices. 



Trace all SVCs. 



Trace all SVCs. 



None. 



Notes: 1. Specification of F1 or F2 is valid for MPS supervisor only. Only SVCs and 31 are recorded for the QTAM trace. 

2. The trace and ignore options are mutually exclusive. 

3. The output device and AAA options are mutually exclusive. 

4. GO will generate default parameters. 

5. END means 'Press the END key', or for Models 1 15, 125, and 158 press the ENTER key. 

6. A magnetic tape unit is the only valid output device for the QTAM trace. 

7. Not applicable to the Transient dump. 

Table B-4 Options and control statements for executing the PDAID trace routines. 

Six examples of initiating trace routines via SYSIPT, followed by five examples of initiating via SYSLOG, immediately follow 
the last of those flowcharts. 
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Trace Routines 



Operator's 
flowcharts 



//JOB PDTRACE 
//EXECPDAID 



4C10DPDAID= 



Enter XX 
and press 
END key 



Select a 

trace 

function 



Press 
END 
only 



Trace events 
specified by 
the function. 



Terminate present, 
trace routine. 



Read parameters 
ft-om SYSIPT. 



Begin selected trace 



4C1 ID OUTPUT DEVICE^ 



Enter GO 
and press 
END key 



Press END 
key 



Specify an 
output device 
X'cuu' 



o 



4C27D AAA= 



Enter GO 
and press 
END key. 



Specify a 
value for 
alternate area 



Press 
END 
only 



One of four 
messages is issued 



Assume core 
wrap output 
mode with 
default parameters 



Log trace in 
specified alternate 
area 



Log trace 
in PD area 



I/O trace 



A 




Log trace on 
specified device 



F/L trace 




GSCV trace 




QTAM trace 








To part 2, 3, 
4 and 5 



To part 2 To part 3 To part 4 To part 5 



PDAIDS 
Initializing PDAIDS part 1 of 5 



IT - I/O Trace 

FT- Fetch /Load Trace 

GT-GSVC Trace 

QT- QTAM Trace 

TD - Transient Dump (A-4-F) 



r 



Specify the hexadecimal channel 
and unit number of either a 
magnetic tape unit or a printer 
for the output device of the 
PDAID. 

Note: A magnetic tape unit is the 
only valid output device for the 
QTAM trace. 

Specify the number of bytes 
allocated to an alternate area. The 
value must be an even integer, 
otherwise the next higher even 
integer is used. 

For a description of these 
messages and required operator 
responses, see 
Specifying an Alternate Area. 

For an I/O, F/L, or GSVC trace 
the device is a line printer or 
magnetic tape unit. For a QTAM 
trace the device may only be a 
magnetic tape unit. 



B-4-F 
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Trace Routines 



PDAIDS 

Initializing PDAIDS part 2 of 5 



From part 1 



From part 1 




4C13D IGNORE DEVICE = 



Specify the hexadecimal channel and 
unit number of the device to be 
ignored (X'CUU') and press END key. 
A maximum of 3 may be specified. 

Note 

The trace and ignore options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced (X'CUU') and press END key. 
A maximum of 3 may be specified. 



Select 
device (s) 
to be ignored 



Press 
END 
key 



Enter 
GO 



4C14D TRACE DEVICE = 



Select 
device (s) 
to be traced 



Ignore these 
devices 
(Maximum of 3) 



Press 
END 
only 



Enter GO 
and press 
END 



Trace only 
these devices 
(Maximum of 3) 



Assume that all 
devices are to 
be traced 






Begin trace routine 



Store I/O events 
in the PD area or 
an alternate area 



Display I/O events, 
by 'dumping' 




//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

/* 

/& 



I 



Display I/O events 
using this utility 
program 



Display I/O events 
as they occur 



o 
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PDAIDS 
Initializing PDAIDS part 3 of 5 



^^"\ 
^t^^ 



From part 1 



From part 1 



4C12D TRACE PARTITION = 



Enter GO 
and press 
END key 



Press 
END 
only 



Select 
partition 
to be traced 



Assume that all 

partitions 

are to be traced 



SP - Supervisor 
BG - Background 
F4 - Foreground 4 
F3- Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 



Trace specified 
partitions 








O 



Store F/L events 
in the PD area or 
an alternate area 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



Display F/L events 
as they occur 



Display F/L events 
using this utility^ 
progra m 



Display F/L events 
by 'dumping' 
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PDAIDS 

Initializing PDAIDS part 4 of 5 



From part 1 



From part 1 



SP - Supervisor 
BG- Background 
F4 - Foreground 4 
F3 - Foreground 3 
F2 - Foreground 2 
F1 - Foreground 1 




A 



4C12D TRACE PARTITION = 



SPECIFY 
partition 
to be traced 



Enter Go 
and press 
END l<ey 



4C16D TRACE SVC 



Specify the hexadecimal SVC number 
to be traced by the GSVC trace. A 
maximum of 6 may be specified. 



Assume all 
partitions to be 
traced 



SVC(s) 
to be 
traced 



Press 
END 
only 



Enter Go 
and press 
END key 



Specify the hexadecimal SVC number 
to be ignored by the GSVC trace. A 
maximum of 6 may be specified. 



4C15D IGNORE SVC = 



Specify Press 

SVC(s) or END 

to be ignored only 



Enter Go 
and press 
END key 



Trace these SVCs 
(Maximum of 6) 



Ignore only 
these SVCs 
(Maximum of 6) 



Store SVC events 
in the PD area or 
an alternate area 




o 



Assume that all 
SVCs are to be 
traced 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



Display SVC events 
by 'dumping' 



Display SVC events 
using this utility 
program 



Display SVC events 
as they occur 
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from part 1 



from part 1 



PDAIDS 
Initializing PDAI DS part 5 of 5 



4C13D IGNORE DEVICE = 



Select 

device (s) 

to be ignored 



Press 
END 
only 



Enter GO 
and press 
END key 



4C14D TRACE DEVICE = 



Press 
END 
only 



Select 
device to 
be traced 



Enter GO 
and press 
END key 



Ignore 
these 

devices (Max. 
of 3) 



Assume all 
devices to be 
traced 



Trace only these 

devices 

(Max of 3) 



*J 



O 



4C12D TRACE PARTITION 



Press 
END 
only 



I 



Enter GO 
and press 
END key 



Specify 
Partition 
to be traced 



Assume all 
partitions to 
be traced 




Specify the hexadecimal channel and 
unit number of the device to be 
ignored X'CUU' and press END key 
A maximum of 3 may be specified. 

Note: 

The trace and ignored options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced X'CUU' and press END key. 
A maximum of 3 may be specified. 




SP Supervisor 
BG Background 
F4 Foreground 4 
F3 Foreground 3 
F2 Foreground 2 
F1 Foreground 1 



Assume all 
devices and all 
partitions to 
be traced 



J 



Commence trace 
routine 



//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

//"MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



:x 



Store QTAM 
events in 
PD area or an 
alternate area 



Display QTAM 
events using this 
utility program 



I 



Display QTAM 
events by 'dumping' 
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PDAIDS 



The following six examples show job streams to initiate trace routines through 
SYSIPT. 

Examples 1 — I/O Trace Function (single entry per card): 



//J0BCARDINP1 

//EXECPDAID 

PDAID=IT 

AAA=2K 

IGNORE DEVICE=190 

IGNORE DEVICE=191 

GO 

/* 

/& 



Calls for initializer. 
Calls for I/O trace function. 
Specifies alternate save area. 
Ignores events from 190. 
Ignores events from 191. 
Signals end of input. 



Note: No output device is specified; therefore, core-wrap is selected by default. To 
obtain the data, held in the alternate area, SYSLST must be assigned to either a 
line printer, tape unit, or disk drive. Exercise care, therefore, during termination 
ofPDAID. 

For example: 

//ASSGNSYSLST, X'191' 
//EXECPDAID 

ensures that the alternate area is dumped on device 191 before responding XX to 
the message 4C10D PDAID=. 

Example 2 — I/O Trace Function (multiple entries): 



//J0BCARDINP2 

//EXECPDAID 

PDAID=IT, IGNORE DEVICE=OOE, 

OUTPUT DEVICE=180, 

GO 



Calls for initializer. 



Calls for I/O trace function. Specifies that 
the function ignore interrupts from OOE and 
record I/O events on 180. (Assume 180 is a 
tape unit) Signals end of input. 






//EXEC ASSEMBLY 

Source 

Deck 


I/O activity of assembler will be traced; 
output will be on tape drive 180. 


/* 

//EXECPDAID 

PDAID=XX, 

/* 

//ASSGNSYS005,X'180' 

// MTC REW,SYS005 
//EXECPDLIST 

/* 


Terminates I/O trace function. 


Assigns tape to SYS005. 

Rewind the tape. 

Print out contents of tape on the printe 

using the PDLIST program. 

program. 



/& 



Tape is formatted and Hsted on SYSLST. 
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Example 3 — Fetch/Load Trace Function (partitions specified): 



Trace Routines 

PDAIDS 



//J0BCARDINP3 

//EXECPDAID 

PDAID=FT 

TRACE PARTITI0N=F2 

TRACE PARTITION=BG 

GO 

r 
/& 



Calls for initializer. 
Calls for F/L trace function. 
Trace foreground 2 partition. 
Trace background partition. 
Signals end of input. 



Note: Because no output device (OUTPUT DEVICE=) is specified, core-wrap is 
selected by default. 



Example 4 — Fetch/Load trace Function: 



//J0BCARDINP4 

//EXECPDAID 

PDAID=FT 

OUTPUT DEVICE=OOE 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Specifies printer output. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 



Example 5 — GSVC Trace Function: 

//J0BCARDINP5 

//EXECPDAID 

PDAID=GT 

OUTPUT DEVICE=OOE 

TRACE PARTITION=BG 

TRACE PARTITI0N=F2 

TRACE SVC=01 

TRACE SVC=04 

GO 

r 
/& 

Example 6 — QTAM Trace Function: 

//J0BCARDINP6 

//EXECPDAID 

OUTPUT DEVICE=180 

TRACE DEVICE=183 

TRACE DEVICE=OOE 

GO 

/* 

/& 



Calls for initializer. 
Calls for GSVC trace function. 
Specifies printer output. 
Trace background partition. 
Trace foreground 2 partition. 
Trace SVC 1. 
Trace SVC 4. 
Signals end of input. 




Calls for initializer. 
Specifies tape output. 
Trace events on tape drive 183. 
Trace events on printer. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 
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PD A I DS The following five examples show job streams to initiate trace routines through 

SYSLOG. 

Example 1 — Store all I/O events in core using PD area for tables: 

//J0BTYPINPT1 

// EXEC PDAI D Calls for initializer. 

4C10D PDAI D= Console requests function. 

IT and press END Operator response: I/O trace function. 

OUTPUT DEV1CE= Console requests output device. 

GO Operator response: end of input (PD area 

is used for output). 

Note: Because no output device is specified, core-wrap mode is selected by default. 



o 
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Example 2 — Trace I/O events from three specified devices, using printer output: 



Trace Routines 

PDAIDS 



//J0BTYPINPT2 
//EXECPDAID 
4C10DPDAID= 
IT and Press END 
OUTPUT DEVICE= 
OOE and press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 

180 and press END 
TRACE DEVICE= 
090 and press END 
TRACE DEVICE= 
OIF and press END 

Note: GO does not have to be specified here. The initializer knows this is the end 
of input because three TRACE entries have been made. 

Example 3 — Trace only the background partition and store the F/L events in the 
PD area: 



Calls for initializer. 
Console requests function. 
Operator response: I/O trace function. 
Console requests output device address. 
Operator response: printer output. 
Console requests IGNORE parameters. 
Operator response: no devices to be ignored. 
Console requests devices to be traced and 
the operator specifies them. 



//J0BTYPINPY3 

//EXECPDAID 

4C10DPDAID= 

FT and press END 

OUTPUT DEVICE= 

END 

AAA= 

Press END 

TRACE PARTITION= 
BGand press END 
TRACE PARTITION^ 
GO and press END 



Calls for initializer. 

Console requests function. 

Operator response: F/L trace function. 

Console requests output device. 

Operator response: core-wrap mode. 

Console requests alternate area. 

Operator response: no AAA; store events in 

PD area. 

Console requests partition to be traced. 

Operator response: background. 

Console requests second partition. 

Operator response: end of input. 




^^gpr 
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Example 4 — Trace all SVC's in both foreground partitions and list events 
on printer. 



// J0BTYPINPT4 

//EXECPDAID 

PDAID= 

GT and press END 

OUTPUT DEVICE= 
OOE and press END 
TRACE PARTITION^ 
F1 and press END 
TRACE PARTITION= 
F2 and press END 
TRACE PARTITION= 
Press END 

IGNORE= 
Press END 
TRACE SVC= 
GO and press END 



Calls for initializer 

Console requests function 

Operator response. Generalized SVC trace 

function 

Console requests output device 

Operator response: Printer output 

Console requests partition to be traced 

Operator response: foreground 1 

Console requests second partition to be traced 

Operator response: foreground 2 

Console requests third partition to be traced 

Operator response: no more partitions 

to be traced 

Console requests first SVC to be ignored 

Operator response: No SVCs to be ignored 

Console requests first SVC to be traced 

Operator response: Trace all SVCs: end of input 



^(mju,jjr 
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Example 5 - Trace interrupts on tape drive 180 and printer OOE using the QTAM 
trace function and store the events in the PD area: 



Trace Routines 

PDAIDS 



//J0BTYPINPT5 
//EXECPDAID 
4C10DPDAID= 
QT and press END 
OUTPUT DEVICE= 
Press END 
AAA= 
Press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 
180 and press END 

TRACE DEVICE= 
OOE and press END 

TRACE DEVICE= 
Press END 

TRACE PARTITION= 
F4 and press END 
TRACE PARTITION^ 

Press END 



Calls for initializer. 
Console requests function. 
Operator response: QTAM trace. 
Console requests output device address. 
Operator response: PD area. 
Console requests alternate area. 
Operator response: no alternate area. 
Console requests device to be ignored. 
Operator response: no device to be ignored. 
Console requests device to be traced. 
Operator response: Trace interrupts on 
device 180. 

Console request second device to be traced. 

Operator response: trace interrupts on device 

OOE. 

Console requests third device to be traced. 

Operator response: no third device; end of 

input. 

Console requests first partition to be traced. 

Operator response foreground 4. 

Console requests second partition to be 

traced. 

Operator response: end of input. 







f% 
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PART 2 SDAIDS 



General description 

SDAIDS provide further tracing facilities to supplement those already provided by 
the PDAIDS. While the PDAIDS produce a predefined output for each type of 
trace, as described in Part 1 of this Section, most of the SDAID trace functions can 
be initiated to produce information that is more defined for a given type of system 
malfunction. The SDAID printout ranges from one printed line for each event up to 
a dump of the complete real storage for each event. (No events will be lost as 
they may be with PDAID output.) SDAIDS also provide special dumping 
facilities that enable non-destroying dumps to be executed on the occurrence of 
specific events during program operation. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceabiUty aid. 



The SDAID trace functions are as follows: 

1. A page trace, consisting of 

• a page translation exception trace (when a page fault occurs) 

• a page enque trace (when a page is placed in the page queue) 

• a page handling trace (when a page is removed from the page queue) 

2. An instruction trace that records instructions in the order in which they are 
executed between any selected addresses. 

3. A main storage alter trace that records the address of the instruction that 
altered the contents of any or all byte locations between any selected 
addresses. 

4. A general register alter trace that records any alteration made to any one, or 
any selected, general registers. 

5. A successful branch trace that records the address at which a successful branch 
is made, between any selected addresses. 



o 



J 



The stop and dump facilities are: 

1. Stop on event: On the occurence of one or any of the following specified 
events, all system activity is suspended after SDAID output is complete. 



at any specified instruction address 

on alteration of any byte location between any selected addresses 

on alteration of one or more specified general registers 

on any successful branch that occurs between any selected addresses 

on the occurrence of a page translation exeption 

on the occurrence of a program check code X'Ol'— X'lO' and X'12' 

on the occurrence of a request for a page to be placed in the PG queue 

(page fault enqueued). 

on the occurrence of a request for a page to be removed from the PG 

queue by the page handler. 
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Trace Routines 

2. As well as being able to obtain a dump of areas specified by the output class at SD Al DS 

the stop event, it is possible to obtain a dump of real and virtual address areas 
after the specified output class has been dumped. 

The types of dumps that can be obtained in this way are: 

• Non-destroying dump: This is a dump of all real storage. It can be obtained if 
required after a stop on event. The dump is non-destroying because system 
status information is preserved, thus enabling system operation to continue 
after execution of the dump. 

• Dump on a program check: On the occurrence of a program check interrupt 
(codes X'Or to X'OF', X'lO', and X'12'), a non-destroying dump of the 
complete supervisor area is automatically executed. 

• PDUMP: Enables a dump of a minimum area of 32 bytes (one print line) 
between two virtual address limits. The maximum area that can be dumped 
depends only on the size of virtual storage, and only virtual address 

area information that is in real storage is dumped. 

System requirements 

The SD area need not be specified during system generation, but the SDAID initial- 
izing and terminating programs must be cataloged in the core image library. 

SDAIDS make use of program event recording and monitoring, described in 
Appendix E. 

Output from all SDAIDS routines is directed to a line printer. The line printer is 
non -dedicated, meaning that the same printer may be used as an output device for 
other programs as well as for the SDAIDS. Therefore, SDAID output may be 
interspersed with job output. 

Note: the following restriction, if the printer is connected via a selector or block 
multiplexer mode channel: 

No other devices must be running on the same channel as the printer at the moment 
when SDAID attempts to write to the printer. 
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SDAID Characteristics 

• SDAIDS reside in the SD area, which must occupy at least 6K bytes of the 
real address area. 

The storage assigned to the SD area is taken from the page pool. 

• SDAID is initialized by // EXEC SDAID, and requires 12K of a real or virtual 
partition (only during initialization of any SDAID function). Parameters, 
specified either at initialization time or later, must be entered on the console. 

• After initialization, SDAID does not use DOS/VS services, 

• SDAID has immediate control in case of a program check interruption. 

• SDAID runs with DAT (Dynamic Address Translation) off, disabled for I/O and 
external interrupts. 

• After SDAID handled event, processing continues as if event handling had not 
occurred. 

• Only the contents of the real address area is dumped with SDAID. (Pages that 
currently reside only on the page data set will not be dumped.) 

• SDAID may not be used to debug time-dependent programs because it runs 
disabled while recording events and thus delays processing. 

• Because SDAIDS use the program event recording PER facility, and because 
time is required to print SDAID output, program execution time is increased. 
Its effect on the operation of time-dependent programs must therefore be 
considered before using this serviceability aid. Performance degradation when 
using SDAIDS will be reduced when the FASTREC output class is selected. 

• Debugging of printer error recovery routines is possible only if the FASTREC 
output class is used. 

• If, during the printing of SDAID output, the line printer is stopped for any 
reason or becomes not ready, the system will enter a wait state with a message 
in low address storage. To continue printer operation, press the EXTERNAL 
INTERRUPT key. 

• When initialization is complete, the event handling routines within the SDAID 
initiating program partition are transferred to the SD area. The 1 2K partition 
can then be re-used, but the pages occupied at the end of the page pool by the 
SD area are not released for normal program use until all SDAID functions are 
terminated. 
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Terminating the SDAID routines 

The tool SDAID is terminated, and the SD area is released to the page pool by 

one of the following: 

1 . The AR (attention routine) command ENDSD 

2. The job control statement // EXEC ENDSD 

Note: Depending on tlie events being traced and the event limits specified, it may 
take some time before the attention routine or job control becomes active. One 
method to avoid this delay is to clear control register 9 using the ALTER jDISPLA Y 
console feature before requesting the attention routine. 
This de-activates all PER event tracing. 
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Using SDAID and PDAID concurrently 

If the system has been generated to accept PDAIDS, any one of the PDAID trace 
routines may run concurrently with SDAID. However, if the PDAID currently 
running is using an alternate area, it must first be terminated before an SDAID 
routine can run. 






SDAID Events 

SDAID events are recognized as program checks. There are two groups of events: 
elementary events and dedicated events. 

Elementary events are: 



Mnemonic 


Event 


BR 

IF 

SA 

GA 

TE 


successful branching 
instruction fetching 
storage alteration 
general register alteration 
page translation exception 



Dedicated events are: 



Mnemonic 


Event 


PGMCHK 

PAGENQ 
PAGEHDL 


program interruption codes 
X'Or-X'OF' and X'10', X'12' 
request for page is enqueued 
request for page is handled 




SDAID output information 

When an event occurs, the SDAID event handling routines will record either the 
information specified by output class parameter (for elementary events), or 
predefined data (for dedicated events). 

By using the output class parameter of the SDAID operand OUTCL= the amount and 
and type of information required for offline program debugging can be selected for 
the elementary event during initialization of the SDAIDS. After initialization, the 
output class can also be re-specified if required. 

For elementary events the output class can be specified according to Table B-6-A. 
However, if more than one elementary event is being traced simultaneously, the 
output class will be the same for all events. For each dedicated event, a 
predefined output is obtained as shown in Table B-6-B. 
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Output if more than one event is being traced: This is desirable when many events 
are to be traced between wide event Hmits. It decreases the amount of printer 
output and reduces print time. Therefore, the larger the space allotted to SDAID 
during initialization, the larger is the SD buffer area for FASTREC output. 

Events can be enabled individually or in combination with one another. If some or 
all of the events BR, IF, SA, and GA happen concurrently, the output class Usted 
in Table B-2-A is printed only once. The event ID, however, contains the mnemonics 
of all current events. 

If any of the other events happen concurrently, even if they occur together with 
one of the events BR, IF, SA, or GA, the output is printed for each event that 
occurs. 

PDUMP output class: A PDUMP is triggered by events just as the other output 
classes. It dumps a minimum of 32 Bytes (one print line) between two virtual 
address limits. The maximum area that can be dumped depends only on the size of 
virtual storage. Any are a between the two limits, not in real storage, will be 
indicated by a message. 

Any PDUMP limits may be specified. However, the value of the limits in relation 
to the value X'CO' and to each other determines the output. 




No 



\^ 



Yes 




No 



Dumping to end 
of storage occurs 
(no wrap-around) 



Yes 



SDAID forces 
lower limit of 
000000 



SDAID selects 
output class of 
LOCORE 



Note: The defaults for the PDUMP limits are the EVENT limits (X'llllir, 'hhhhhh ') 
specified in answer to message 4C61D, refer to Table B-10. 
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00 



Pi 
a' 



& 






^^~~-,^^ Output classes 
^^■^-.^^^ and 
Recorded ^^^^^^ Mnemonic 
Information ^■-'-^^,^ 


OUTCL 1 


OUTCL 2 


OUTCL 3 


OUTCL 4 


OUTCL 5 


OUTCL 6 


OUTCL 7 


OUTCL 8 


OUTCL Q 


PSW 
01 


GPR 
02 


LOCO RE 
03 


COMREG 
04 


PAGETAB 
05 


SUPVISOR 
06 


DUMPREAL 
NDD07 


PDUMP 
08 


FASTREC** 
00 


Event ID* 

program old PSW, and time of day 

in microseconds 


X 


X 


X 


X 


X 


X 


X*** 


X 


X 


Instruction causing event 


X 


X 


X 


X 


X 


X 


X*- 


X 




General purpose registers 




X 


X 


X 


X 


X 


X 


X 




Low core (X'OOO'-X'1 1 F') 






X 


X 


X 


X 


X 






Current COMREG and SYSCOM 








X 




X 


X 






Control registers. 






X 


X 


X 


X 


X 


X 




segment tables, 
page tables, 
page frame table 










X 


X 


X 






Complete supervisor 












X 


X 






Complete real address area 














X 






Virtual dump between 
PDUMP address limits 
















X 




TE-MASK 

PER mask (control register 9) 

GPR mask (control register 9) 

PER start address (control register 10) 

PER end address (control register 1 1 ) 

general purpose registers 1 3, 14, 1 5, 0, 1 , 2 


















X 



Notes 

* Event ID for BR, IF, SA, and GA — event mnemonic and instruction address. 

Event ID for TE — mnemonic TE and address of the page causing TE. 
** FASTREC is an output class that stores the described information into an SDAID internal buffer. 

Information for several events is stored and printed as one block. 
*** INSTR and PSW are not printed if NDD is forced after STOP ON EVENT VIA NDD BYTE X'FF'. 

Table B-6-A . Output class options for SDAID elementary events. 

Examples at the end of this section 2-F show several types of output specified by the output class parameter. 
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Recorded Information 


Dedicated Event 


PGMCHK 


PAGENQ 


PAGE HDL 


Event-Mnemonic 

Program old PSW, 

Time of day in microseconds. 

Complete supervisor. 

Instruction at time of PGMCHK 

Control registers 

General purpose registers 


X 






Event-IVinemonic 

Requestor-ID 

(TE/GETR/TFIX/PFIX) 

Task-ID 

Address of page to be handled 




X 


X 


Protection key associated with 
page to be handled 




X 


X 


Address of page frame 

to which the page is assigned 






X 



o 



Table B-6-B. Predefined output obtained from SDAID dedicated events. 



Specification of area to be traced 

For elementary events, two addresses may be specified during SDAID initialization 
as the start and end addresses of the area to be traced or monitored. These 
address limits are interpreted as virtual addresses if the DAT bit in the PSW is on. 
Address limits are not applicable to dedicated events, for which the SDAID 
program includes all real and virtual address areas. 

If the start address specified is higher than the end address, tracing commences from 
the higher address and continues to the end of virtual storage (the maximum 
address being 16,777,215). Tracing continues from address 000000 up to the end 
address (the lower address specified). This is termed "wrap around tracing". 



o 
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Translation exception trace 

This occurs when an instruction requires a page to be paged in from the page data 
set in order for the instruction to be completed. An example is an MVC instruction 
whose address 1 is in page frame x in real storage, and whose address 2 is in page y 
that is not in real storage. 

When this trace is initialized, any page fault generated because of such an instruction 
is printed along with the instruction and its address that caused the page fault, plus 
the output of the specified output class. 

Page enqueue trace 

This trace enables the sequence to be traced in which programs are calling for 
pages. Page faults caused by translation exceptions will also be traced with 
this routine. 

Page handling trace 

This trace provides information about the sequence in which pages are paged in 
from the page data set. After a page is handled, a trace output is printed. 

When to use: Use this trace if you suspect that the loss of a page, or the sequence 
of page usage by a program, is causing programming errors. This trace gives you page 
management information during program execution. 
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Instruction trace 

This trace records information about the order of instruction execution within any 
selected area of storage during program execution. The amount and type of 
information provided depends on the output class selected during initialization of 
the trace. 



When to use: If an unintended loop develops during program execution, this trace 
can be initiated and the program re-run. During the re-run, a list of all the instruc- 
tions executed within the loop will be traced. This is an efficient method to 
obtain a loop trace. 



Storage alter trace 

This trace records information about instructions that alter one or more locations 
in virtual storage between address limits that can be specified. The amount and type 
of information provided depends on the output class selected during initialization 
of the trace routine. 



When to use: If, for example, you suspect I/O areas or count locations for loops, 
information obtained from this trace output will show the instructions that are 
altering the areas. The SA trace will not record changes in the contents of locations 
that are changed directly by I/O channel operations. 



General register alter trace 

This is similar to the virtual storage alter trace. It should be used when information 
about changes to any GR during program execution is required to help during 
offline program debugging. Any GR or any combination of GRs can be traced. 



Successful branch trace 

This trace provides a check on the logical path of a program during its execution 
in any selected part of virtual storage. 



o 



When to use: Use this trace if the actual path taken by a program cannot be 
analysed from the program flowcharts and listings. You can also use it to provide 
information about the path taken, for example, by a long loop. 
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Stop and dump routines SDAIDS 

Stop on event 

This facility stops all system activity on the occurrence of a specified event. At the 
stop on event, the system is held in a wait state. 

Processing continues via external interrupt. 

With the system in this wait state, the operator or programmer can either use 
hands-on debugging aids or obtain a non -destroying dump. 

The specified event can be one or more of the elementary or dedicated events. 

When to use: 

1 . Use this routine if hands-on debugging is necessary on the occurrence of one of 
the specified events. For example, when a change occurs in a general register, 
you may want to look through the program Ustings to enable you to decide on 
the next step in isolating an error. When the stop occurs, it is also possible to 
initiate another SDAID routine that will provide additional system information 
for offline program debugging. 

2. When no time is available for hands-on debugging, the non-destroying dumps 
obtained when the stop on event occurs will provide a great deal of additional 
information for offline program debugging. 

Stop on address 

This facility provides a stop on address on any specified (real or virtual) address. 
When the stop occurs, the system is held in a wait state, and the operator or 
programmer can use hands-on debugging aids or obtain a non-destroying dump. 

When and how to use: This facility is used under conditions similar to those for the 
hardware stop on address compare, that is, hands-on debugging is to be carried out 
when a program has reached some specific point during its operation. However, this 
aid enables a stop on all SDAID events. 

The stop on address is accomplished by initiating the instruction trace, specifying 
stop on event, and entering the address at which the stop is required as the address 
supplied within the event limit field during initialization of the trace. 
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Non-destroying dump: This is a dump of real storage that can be obtained after 
the occurrence of a specified event during the stop on event. The dump is non- 
destroying because the system is placed in a wait state on the occurrence of the 
specified event, and because SDAIDS do not destroy system status during 
execution of the dump. 

How to obtain the dump: The following procedure describes how to obtain the 
non-destroying dump: 

1 . When the system is in the stop-on-event wait state, locate the real storage 
address of the NDD (non -destroying dump) byte switch. 

The address of this program switch is printed during SDAID initialization. 
Refer to point 3 of the example in this section which shows the SDAID 
initializing output part 2. 

2. To ensure that the wait state is the true stop-on-event wait, use the ALTER/ 
DISPLAY console feature to display the PSW. The instruction address part of 
the WAIT PSW will be OOOOEEEE. 

3. To obtain the dump, set the NDD byte to X'FF', using the ALTER/DISPLAY 
console feature as described in this Section 2-D. 

4. Press the START key and then the EXTERNAL INTERRUPT key. A non- 
destroying dump will be printed and processing continues. 

When the dump is complete, the NDD byte is reset by the SDAID program, and so 
a dump will not occur at the next stop on event. To obtain another dump at any 
following stop, the NDD byte must again be set on. 

Note: The dump can be discontinued by the following procedure: 

1. Make the line printer used as SDAID output device unready. 

2. Now make the printer ready. 

3. Press the EXTERNAL INTERR UPT key two times within one second. 

When to use: This SDAID faciUty enables you to obtain the information needed 
for problem analysis without having to take dumps of real storage at every 
occurrence of an event. Therefore this decreases the amount of paper to be searched 
through during offline debugging. For example you may consider it sufficient 
for offline debugging to take a dump at every twenty seventh occurrence of an 
event. 
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Dump on a program check: On the occurrence of a program check interrupt codes 
X'Or - X'OF', X'lO', and X'12', the following information is dumped automatically: 
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Event ID 

Program old PSW 

Time of day in microseconds 

Control registers 

General purpose registers 

Real storage from byte location to the end of the supervisor area, and the 

contents of the SDAID buffer. 



After this automatic non-destroying dump is executed, the DOS/VS program 
check handler routine will be entered. 

When to use: If PDAIDS are not available on your system, the use of the SDAID 
dump on a program check is the only way to obtain a non-destroying dump of the 
supervisor transient area at the time of a program check interrupt. 

The SD area 






/ 

END OF 

REAL STORAGE 




Real Partitions 
if any. 



SUPERVISOR 



IVIAIN 
PAGE 
POOL 



/ 

END OF 

REAL STORAGE 



SDAID resident code 
and work space. 

SD Buffer 



SD AREA 
'^ (6K by default) 



Length of each event is 64 bytes. 



Real storage allocation 
before initializing SDAIDS 



Real storage allocation 
after initializing SDAIDS 



How to locate 

The address of the beginning of the SD area is printed on the device assigned to 
SYSLST during initialization of SDAID. Refer to page 2.90 for an example of 
SDAID initializing output. 
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Initializing SDAID 

SDAID may be initialized in any real or virtual partition by entering the following 
execute statement via SYSLOG or SYSRDR: 

//EXEC SDAID 

An operator/ system dialog follows, beginning with the message: 

4C55D GIVE SPACE FOR SDAID= 

The operator may respond by pressing the END key (which gives a default value of 
6K to SDAID), or he may specify a value nK, where n represents a multiple of 1024 
bytes. The maximum value that may be specified is 999K. If an odd number is 
specified, the value is incremented to the next even number. The SDAID space is taken 
from the main page pool. If the main page pool is not large enough to accept the 
area specified, an area of the size PP00L-16K is automatically taken, with a minimum 
of 6K. If the page pool is not large enough to accept the minimum(6K), the following 
message is printed on SYSLOG. 

4C56E INSUFFICIENT SDAID SPACE, REALLOCATE 

The MAP command should be issued before reallocating real partition areas in 
order to increase the size of the page pool before re-initializing SDAIDS. 

The following message will be issued if this is a second request for SDAID space: 

4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

This message is also issued if PDAID using the core wrap output mode in an 
alternate area is active in the main page pool and a request for SDAIDS is made. 
When the space allocated to SDAID is accepted, a message dialog follows that allows 
the operator to select one or more events to be traced and to specify between which 
address limits of real or virtual storage the events are to be traced. (Event Hmits 
do not apply to event PAGENQ, event PAGEHDL, and event PGMCHK.) The dialog 
also enables the selection of a line printer at a device address other than X'OOE', 
which is the device address by default. However, the device must be a line printer. 

An output class may also be specified (refer to Tables B-6-A and B-6-B in this chapter). 
A response of EOB (pressing the END key) to all SDAID messages will give default 
values. 

When the SDAID message dialog is complete, the SDAID initializing outputs part 
1 and 2 are issued to the device assigned as SYSLST. This need not be the same 
device on which SDAID trace output is printed. The SDAID trace output is printed 
immediately after the initializing output on the device at the address specified in 
the reply to message 

4C58D OUTPUT DEVICE= 

(Address X'OOE' is taken as default.) After initialization, the partition used for the 
initialization is given back to the main page pool. 

The table shown in Figure B-3 Hsts all SDAID messages in the order in which they 
are issued and describes the responses. 

SDAID job entry examples are shown after the example of the SDAID initiaUzing 
output. Operator flowcharts follow. 

SDAID messages after initialization time 

4C71 1 SDAID FOUND PRTR STATUS CSW SENSE 

This message may be written out on the printer. It is accompanied by the CSW and 
SENSE information if appUcable. It indicates that the previous printer operation 
which was started may not have been completed successfully. 



V,.^ 
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A Itering SDA ID functions and /or address limits after initializa tion S D A I D S 

When the SDAID is initiahzed, trace functions and events hmits, where appUcable, 
can be changed by ahering the SDAID program parameters directly in storage. 
The contents of the parameters at the addresses printed on part 2 of the SDAID 
initiahzing output, and of control registers 8, 9, A, and B, must be altered to 
predetermined values. Their values are also printed in the initializing output. 

To make SDAID parameter changes: 

• Press the STOP key. 

• Use the console ALTER/DISPLAY feature to alter the contents of the 
program parameters. 

• Press the START key. 

Note: When SDAID is terminated and later re-initialized, new SDAID parameters 
are printed in the SDAID initializing output. 

Note: SDAID requires SYSLSTfor the initializing output. Therefore, if you 
intend to change SDAID parameters after initializing SDAIDS, you should ensure 
that the SYSLST device is a line printer on the partition used for SDAID 
initialization. 

A note to programmers 

SDAIDS are primarily designed to be initialized before re-running failing programs. 
If you, as the programmer, are debugging on the system (hands-on debugging), it 
is recommended that you initiate SDAIDS without specifying any events. (Press 
the END key as a response to all SDAID messages.) SDAID is then retained in the 
page pool ready to be activated. The failing programs can then be executed and 
SDAID events made active by entering event parameters directly into control 
registers 8, 9, 10, and 11. For example, altering the contents of the high-order byte 
of control register 9 (by the console ALTER/DISPLAY feature) enables you to 
activate any one or all of the events BR, IF, SA, and GA. 

You can also specify which general registers are to be traced by entering values 
into the lower 2 bytes of control register 9. Control registers 10 and 1 1 contain, 
respectively, the start and end addresses for the event limits. The output of the 
MAP command will tell you the partition in which the failing programs reside. 

From the MAP output you can also obtain the addresses of the upper and lower 
limit of the partition, which can then be used as the event hmits for the SDAID 
trace. (Note that addresses printed by the MAP command are decimal.) 

If you are unable to use the system for hands-on debugging, you as the programmer 
must specify clear instructions to the operator about the events to be traced and 
the event limits to be used. 
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Message 
Code 


Message issued 
on SYSLOG 


Parameters entered by Operator 


Remarks 


4C58D 


OUTPUT DEVIOE= 


X'OOE' [,GOl" 
X'cuu' [,G0] 
GO 


END/ENTER 




4C60D 


STOP ON EVENT= 


Z' [.-] 


END/ENTER 




4C61D 


EVENT LIMITS= 


X'OOOOGO'.X'FFFFFF' 


_[.GOJ ■ 
[.GO] 1 
[.GO] 


END/ENTER 


X'limi'.X'hhhhhh': 
Lower and upper limit of virtual 
storage to be traced with events 
BR. IF.SAandTE. 


X'llllll' ' 


X'llllll' 

X'hhhhhh' 

GO 


4C59D 


OUT0L= 


PSW 

GPR 

LOOORE 

COMREG 

PAGETAB 

SUPVISOR 

DUMPREA 

PDUMP 
FASTREC 


L 

.lowe 
.X'aa< 

.GO 

'.PGM 
,AUT 
.,GO 


.GO 

r and 
aaaa' 

OHK 
OMA 


upper event 
.Upper evenl 
.X'bbbbbb' 

.,G0 

[,G0] 
TIC [.GO] 


imit [,G0] 
t limit [,G0] 
CGO] 


J 


END/ 
ENTER 


Valid output classes for the events 
BR, IF.SA, GA.andTE. 
END/ENTER 

PGMCHK: Causes wrap around 
mode of internal buffer. It is 
written each time a PGMCHK 
event occurs. AUTOMATIC: 
If the internal buffers is full, 
it is written out. 


4062 D 


EVENT BR= 


L't-] 


END/ENTER 




4063 D 


EVENT IF= 


L"c-]] 


END/ENTER 




4064 D 


EVENT SA= 


^i^[.-i] 


END/ENTER 




4065D 


EVENT GA= 


X'012...EF' [,G0] 
NO 


END/ENTER 


Designate the general purpose 
registers to be traced. At least 
one must be specified. 


4C66D 


EVENT TE= 


£^= 1.-1 


END/ENTER 




4067 D 


EVENT PGMCHK= 


1^^^ I.-3. 


END/ENTER 




4068D 


EVENT PAGENQ= 


U' t-i 


END/ENTER 




4069D 


EVENT PAGEHDL= 


Ves' 

m 


END/ENTER 





J 



\.y 



\_> 



Note: Go cannot be entered as a first parameter. If it is, the dialogue is terminated ; defaults (underlined) are taken or the parameters 
are ignored by SDAID. 

Table B-10. The parameters required to initialize SDAID event tracing. 
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//JOBSDTRACE 
//EXECSDAID 



4C53I TOD IN ERROR STATE 



or 



4C54I TOD NOT OPERATIONAL 



Select size of SD area 



Enter n 
(a value) 



Press 
END 



4C70E DUPLICATE REQUEST FOR PDAID 
AND/OR SDAID 




NO 
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No operator response is required to 
eittier of tiiese messages if they are 
printed. The time stamp on SDAID out- 
put win be zero. 



Maximum area you may specify is 999l<. 
If n is an add integer, the value is 
incremented to the next even number. 



This message is issued if SDAID has 
been initiated and not terminated before 
a second request to initiate SDAID is made. 
The duplicate, or second request for 
SDAID is automatically canceled. (This 
message is also printed if a request to run 
a PDAID core-vi/rap output in an alter- 
nate area is made while SDAID is active . 






Yes 



SD area size 
is nK 




No 



4C58D OUTPUT DEVICE = 



Device X'cuu' must 
be a line printer 



4C56E INSUFFICIENT SDAID SPACE 
REALLOCATE 



Select a device 



Enter 
X'cuu' and 



Enter 
GO 



Enter 
X'cuu' 



'■" or ^^ or '^ ^"" ^ 

GO and press END I and press END] and press END 



Press 
END 



Use device 
X'cuu' for 
output 



Use device 
X'OOE'for 
output 



Use device 
X'cuu' for 
output 



If this message is printed, the SDAID job 
is terminated. Before re-initializing 
SDAIDS you must decrease the size of 
real partitions, thus increasing the size 
of the main page pool for the SD area. 



Use device 
X'OOE' for 
output 





To part 2 



To part 2 
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From part 1 



From part 1 








4C60D STOP ON EVENT = 



Enter GO 
and press 
END 



Enter YES 

and GO 

and press END 



Enter YES 
and Press 
END 



Press 
END 



No stop 
on event 



Trace events 
across all of 
virtual storage 



Refer to Table B-6-A for a 
description of SDAID output 
classes. 

(FASTRECGO generates the 
default of PGMCHK). Output 
class for the events PGMCHK, 
PAGENQ, and PAGEHDL is 
predetermined. Refer to 
Table B-6-B 



Stop 
on event 



Enter GO 
and press 
END 



Enter GO 
and press 
END 



Take default 
output class of 
PSW (01) 



To part 3 



Stop 
on event 



No stop 
on event 



4C61D EVENT LIMITS 



Enter GO and 
press END 



Specify event limits and 
-~1 



or 
J_ 



Press 
END 



Trace events 
between limits 
specified 



Press 
END 



Trace events 
between limits 
specified 



V.-..-^ 



Trace events 
across all of 
virtual storage 



4C59D OUTCL = 



Enter GO and 
press END 



Specify an output class and 
or 



Press 
END 



Use output 
class specified 



Press 
END 



Use output 
class specified 



Take default 
output class of 
PSW (01) 



( 



.^ 



To part 3 
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From part 2 



From part 2 
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4C62D EVENT BR = 



Enter GO 
and press 
END 



BR = Successful Branch Trace 



Enter YES and 



Enter GO and 
press END 



No BR trace 



Trace BR 
events 



Enter GO 
and press 
END 



No IF trace 



To part 4 



Press 
END 



Press 
END 



Trace BR 
events 



No BR trace 



4C63D EVENT IF = 



IF = Instruction Fetch Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Press 
END 



Trace IF 
events 



Trace IF 
events 



No IF trace 



^ 




To part 4 



Serviceability Aids. 2.91 



Trace Routines 



I'ageot GC33-5380-1, 
revised June 30, 1974 
by TNL SN33-8780 



SDAIDS 

Initializing SDAID, part 4 of 6 



From part 3 






From part 3 



4C64D EVENT SA = 



Enter GO 
and press 
END 



No SA trace 



GA = General Purpose Register Trace 



SA = Storage Alter Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace SA 
events 



Press 
END 



Trace SA 
events 



No SA trace 



4C65D EVENT GA = 



Enter GO 
and press 
END 



Specify GPR(s) to be traced, (in hex) 



Enter GO and 
press END 



T 

or 



Press 
END 



No GPR trace 



Trace G PR (s) 
specified 




Press 
END 



Trace GPR (s) 
specified 



No GPR trace 



c 



To part 5 



To part 5 



2.92 Serviceability Aids. 



Pageof GC33-5380-1, 
revised June 30, 1974, 
by TNL SN33-8780 



Trace Routines 






From part 4 




Enter GO 
and press 
END 



No TE trace 



From part 4 




SDAIDS 
Initializing SDAID, part 5 of 6 



4C66D EVENT TE = 



TE = Page Translation 
Exception Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace TE 
events 



Press 
END 



Trace TE 
events 



No TE trace 



Zi 



4C67D EVENT PGMCHK= 



Enter GO 
and press 
END 



Enter NO and 



Enter GO and i Press 

press END i END 



Trace 
PGMCHK(s) 



PGMCHK = Program check trace 



Do not trace 
PGIVICHK(s) 



Zf 



Do not trace 
PGMCHK(s) 



Press 
END 



Trace 
PGIVICHK(s) 



^ 



To part 6 



To part 6 



Serviceability Aids. 2.93 



Pageof GC33-S380-1, 
revised June 30, 1974 
by TNL SN33-8780 



Trace Routines 

SDAIDS 

Initializing SD AID, part 6 of 6 



From part 5 



From part 5 



\.jr 



4C68D EVENT PAGENQ = 



Enter GO 
and press 
END 



PAGENQ = Trace of page requests 
as they are placed in the page queue 



Enter YES and 



Enter GO and 
Press END 



Press 
END 



No PAGENQ 
trace 



Trace 
PAGENQ(s) 




Press 
END 



Trace 
PAGENQ(s) 



PAGEHDL = Trace of pages as they 
are allocated to a frame in the real 
address area — page request is 
removed from the page queue. 



No PAGENQ 
trace 



J 



4C69D EVENT PAGEHDL = 



vy 



Enter YES 
and press 
END 



No PAGEHDL 
trace 



Press 
END 



Trace 
PAGEHDL 



No PAGE- 
HDL trace 



SDAID initializing output parts 1 and 2 are printed at this 
point during the initialization. The example opposite 
shows and explains the meaning of the initializing output. 
Retain this output if SDAID parameter changes are 
intended after initialization. 



4C57E SDAID SUCCESSFULLY INITIATED SDAREA=XXXXK 



2.94 Serviceability Aids. 



SDAID initializing output, part 1 



o 



SDAIO FOUND/ASSUHEO THE FOLLOMING PARAMETERS: 

SOAID START ADDRESS IS HEX 0003E800 

SDAID END ADDRESS IS HEX 0003FFFF 

SOBUFFER START ADDRESS IS HEX 0003FDCO 

SOBUFFER END ADDRESS IS HEX 0003FFFF ■ 

SDBUFFER CAN KEEP THIS NR OF EVENTS DEC 00000009 



1 PRINTER ADDRESS IS HEX 

2 OUTPUT CLASS FIELD IS 

3 STOP ON EVENT 

4 EVENT LIMITS START HEX 

END HEX 

5 EVENT BR 

6 EVENT IF 

7 EVENT SA 

8 EVENT GA 



OOOE 
PSM (01 > 



00000000 
OOFFFFFF 



ML 



MASK BITS FOR GENERAL PURPOSE REGISTERS .01234567B9ABCDE 



9 EVENT TE 

10 EVENT PGNCHK . 

11 EVENT PAGENQ . 

12 EVENT PAGEHDL. 



OOOOOOOOOOOOOOOQ 



Trace Routines 

SDAIDS 



3FFFF- 3£'9oo = I7fF = 6/4^-i, 



[//if \ % AJtAc/ (;/} ^^^Kx. Oft f/^^ ort^ 

5' a*u/ 7 ^■*t^ i<?C>075oO 



■TM£Keo 



(£xZ3Kr)\ 



SDAID initializing output, part 2 



o 



»*•* THESE ARE THE PARAMETERS THAT YOU CAN CHANGE FROM CONSOLE: 

» PROCEDURE: MACHINE IN STOPPED STATE, HIT ALTER/OSPLY, EXAMPLES BELaH 

* 

• To ALTER CTL REG 9 TO AOOOOCOO 

* TYPE IN AC 9 40000000 END KEY 

• 

* TO ALTER MS LOCATION 03CC8C TO FF 

* TYPE IN AM 03CC8C FF END KEY 

»*I PRINTER ADDRESS ON HEX 03FD88 FORMAT OXXX 

* 

**2 OUTPUT CLASS ON HEX 03FD98 FORM UUYY 

* WHERE if: UU=00 FASTREC 

• UU=OI PSW 

♦ UU=02 GPR 

♦ UU=03 LOCORE 

* UU=04 COMREG 

• UU=05 PAGETAB 

* UU=06 SUPVISOR 
» UU=07 OUMPREAL 

* UU=08 PDUMP 

♦ YY=00 AUTOMATIC SDBUFFER OUTPUT ") . 

* YY=FF SDBUFFER OUTPUT ON PGMCHK J 
* 
•*3 STOP ON EVENT ON HEX 03FD94 X'FF'=YES, X«00'=NO 

• NONDESTROYING DUMP ON HEX 03F096 X»FF'=YES 

* 

**4 EVENT LIMITS START ADDRESS .... CTL REG A HEX OOXXXXXX ADDR 

♦ END ADDRESS .... CTL REG B HEX OOXXXXXX ADDR 
* 

* PDUMP LIMITS START ADDRESS .... ON HEX 03FD9C OOXXXXXX ADDR 
» END ADDRESS .... ON HEX 03FDA0 OOXXXXXX AODR 
* 
* 

* SOAID events: TO ENABLE — SWITCHON THE BIT/BYTE — 
* 

**5 BR EVENT CTL REG 9 HEX 80000000 BIT 

**6 IF EVENT CTL REG 9 HEX 40000000 BIT 

**7 SA EVENT CTL REG 9 HEX 20000000 BIT 

* 

♦*B GA EVENT CTL REG 9 HEX 10000000 BIT 

* GPR MASK (0-151 .. CTL REG 9 HEX lOOOXXXX POSITIONAL 

* » 
•♦9 TE EVENT MAIN STORAGE 03FD8C HEX FF BYTE * 

• * 
«10 PGMCHK EVENT MAIN STORAGE 03F08E HEX FF BYTE * 

* , . ♦ 

♦ 11 PAGENQ EVENT MAIN STORAGE 03FD90 HEX FF BYTE * 

♦ 12 PAGEHDL EVENT MAIN STORAGE 03FD92 HEX FF BY'TE * 

• » 
♦MOTE: SDAIO NEEDS EXTERNAL INTERRUPT IF PRINTER BECAME UNREADY ♦ 

♦ * 

♦ » 
♦♦♦«♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦•♦*♦***«♦*•*•*•«***••*******•*««*•••* 

CPU-ID IS HEX P0O10043J14SP0C0, ^ 

4C57E SDAID SUCCESSFULLY INITIATED SDAREA=0006K T Y^^~^~— ^ 

^ / ^ ■€/></ M-t^ 

CPU Se^tca/ -Ku^H^ 



' ^ -f i^ = C . ^y,^ Co c^ 
j^i^ / - 6'. ^■,p^ So . 



o 



The summary of parameters printed on the line printer 
after successful initialization of any SDAID routine. 



ALL ADDRESSES ARE REAL. 




Serviceability Aids. 2.95 



Trace Routines 

SDAIDS 



1.I60A READY FOR COMMUNICATIONS. 

batch f2 

assgn svs I st fx'OOe '_ 

// exec i> d<3 i d 

4C55n GIVE SPACE FOR SDAID = 

lOk 

4C56E INSUFFICIENT SDAID SPACE» REALLOCATE 

1.I00A READY FOR COMMUNICATIONS. 

map 

AREA K-REAL UPPER LIMIT K-VIRT UPPER LIMIT 

SP 92K 94207 

BG V5A 30K 124927 292K 

F4 14 lOK 135167 80K 

F3 13 lOK 145407 80K 

F2 V2A 14K 159743 lOOK 

Fl II 82K 243711 120K 

SVA 96K 

VIS 68K 

PP 18K 262143 

allocr flr^=14k ^ t 

// exec s da i d * ' " ' 

4C55D GIVE SPACE FOR SDAID = 

10k 

4C58D OUTPUT DEVICE 

4C60D STOP ON EVENT 

4C61D EVENT LIMITS = 
X '040000' ^x'OSOfff 
4C59D OUTCL = 



/t9 



\ 5l>AfD ^Ccf^vce/ii . 






262144 
561151 
643071 
724991 
827391 
950271 
1048575 
1048575 



NAME 



KENSLOOP 



NO NAME 



S? 






ec/^-ccM^ 



4C62D 

Yes 

4C63D 

Yes 

4C64D 



EVENT BR 



EVENT IF 
EVENT SA 






4C65D EVENT QA = 

X' 345678' 

4C66D EVENT TE = 

4C67D EVENT PGMCHK = 

40680 EVENT PAGENQ = 

4C69D EVENT PAGEHDL = 















4C57E 
IIOOA 



SDAID SUCCESSFULLY INITIATED 
READY FOR COMMUNICATIONS. 



SDAREA=0010K 



\AZ 9 



50/HO '^e^yc^ X^TfiymJlcU^et/K^ 



jOQ040000i ^OOOSOFFF] 00000000 00000000 C2000000 00000200 80400040 
FFFFFFFF/ FFFFFFFF 00000000 00000000 00000000 00000000 OOOOFFFF 



C/Z/OX'fi' - "- -^. _.^W -* - 



|000404£A1 



AC A 
tQ004Q43C | 

DC 9 _ 

D0001F80 1 0004043CL , |00047)4E?n . 00000000 00000000 C2000000 00000200 80400040 
O000F600 FFFFFFFF YFFFFFFFF^ 00000000 00000000 00000000 00000000 OOOOFFFF 



F2 



CU I0604O4E?a. 00 
c j FFFFFFFF ^00 






Si>Afd 



AC 9 
00000000 



CXr/ C/l f /^ ^^ y^ etx*t^^ e^x^tf^ t'f/^/^/^cm 



The example above shows the operator-system dialogue on a 3215 PRKB during SDAID initialization. 

After initialization the contents of the control registers have been changed to alter event limits 
and traces. 






2.96 Serviceability Aids. 



o 



Trace Routines 

SDAIDS 



IF GA 

GPR 0-7 
GPR 8-F 
CTL 0-7 
CTL 8-F 
LOW CORE 
00000000 
00000020 
000000'>0 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



C pOOAOASC ) TOD MICSEC 

00000000 0002FOOO 00000030 

00000001 00000B33 OOOOOOOF 
OO^OOOFF OO0OE640 FFFFFFFF 
OOOOFFFF D0001F80 0004043C 

00000000 00000000 00000000 
471D3000 00040't3A 47100000 
00000000 04000000 10003B70 
440C0000 OOOOOBCC OOOCOOOO 
00000540 00000080 0002000A 
C f^ 00000 20000060 

O^ U 00000 00000000 



2333024913754652 

00000000 00000000 
4004007A 0004107A 
FFFFFFFF 00000000 
000404EA 00000000 



PSW AT TIME OF EVENT 471D00000004043E INSTR TT233k 780B3CE 
OOOOOOBE 00000010 00000002 
07C8C1E2 B0040426 000422F8 
00000000 00000000 00000000 
00000000 C2000000 00000200 



/ 



SEGM TABLE< 0OO0E6 40 

0000E640 ,'F6o aE330l FO0OE370 FOO0E3B0 

0OOOE660 "f'o6o1530\FO00E570 F000E5B0 

PAGE TABLES 0OO0E330 

0OOOE320 -0000000 00000000 00000000 

0OO0E340 

0O00E360 

0OOOE38O 

0OOOE3AO 

0O0OE3C0 

0000E3E0 

0000E400 

OO00E420 

0000E440 



00000000 
0004043E 
00000000 
0003BOOC 
00020080 
000002CO 
00000000 



FOOOE3F0 
FOOOE5F0 



00000000 
00000000 
00B62900 
04080000 
12042003 
00000000 
00000000 



X 7"/^ 3. 3 



000004A0 470F2000 0000090C 

0003B174 47100000 0004044A 

02FDB4D4 44OC0000 0O0O0C14 

0000D13A 440COOOO OOOOOBIO 

00025000 0004043C OOOOOICC 

00000100 00000009 00000000 

00000000 00000000 00000000 






F000E430 F000E470 FOO0E4B0 F000E4FO 

oooooooi 00000001 00000001 oooooo 



01 } S&f^'^^!^ 



i.U.O.U.O.UO 



^bto**^ 



00400048 00500058 00600068 00700078/ 
00COO0C8 00000008 00E000E8 00F000F8' 
01400148 01500158 01600168 80118011 
80118011 80118011 80118021 80218021 
80418041 80418041 80418041 80518051 
80018001 80018001 80018001 80018001 
80018001 80018001 80018001 80018001 
03C103C9 03010309 03E103E9 03F103F9 
00150015 00150015 00150015 00150015 
— SAME— 

00150015 00150015 00150015 00150015 
00250025 00250025 00250025 00250025 
— SAME — 

00250025 00350035 00350035 
00350035 00350035 00350035 
00350035 00350035 00350035 
00450045 00450045 00450045 
— SAME — 

00450045 00450045 00450045 00450045 
00550055 00550055 ' A' ti '50055 

—SAME— rage./y O 

OOOOE620 00550055 00550055 >" ^ i50055 
PAGEFR TAB O0O00E88 V -- - 

00000E80 boo a oooo oooooo eo !ooo2oooo_ oooooojop.' 

00020000 00030000 00020000 00040000 
00020000 00070000 00020000 00080000 
00020000 OOOBOOOO 00020000 OOOCOOOO 
00020000 OOOFOOOO 00020000 OOIOOOOO 
00020000 00130000 00020000 00140000 
00020000 00170000 00020000 00180000 
00020000 OOIBOOOO 00020000 OOICOOOO 
00020000 OOIFOOOO 00020000 00200000 
00020000 00230000 00020000 00240000 
00020000 00270000 00020000 00280000 
00020000 002BOOOO 00020000 002C0000 
00000418 00800188 000001A8 FFFF0190 
00000410 008301AO 00000198 00820170 
OOOOOICO FFFFOIBO 000001C8 FFFF01B8 
OOOOOIEO FFFFOIOO 000001E8 FFFF01D8 
00000200 FFFFOIFO 00000208 FFFF01F8 
00000220 FFFF0210 00000228 FFFF021B 
00000240 FFFF0230 00000248 FFFF0238 
00000260 FFFF0250 00000268 FFFF0258 
00000280 FFFF0270 00000288 FFFF0278 
000002A0 FFFF0290 000002A8 FFFF0298 
000002C0 FFFF02B0 000002C8 FFFF02B8 
000002EO FFFF02D0 000002E8 FFFFO208 
00000300 FFFF02F0 00000308 FFFF02F8 
00000320 FFFF0310 00000328 FFFF0318 
00000340 FFFF0330 00000348 FFFF033e 
00000360 FFFF0350 00000368 FFFF0358 
00000380 FFFF0370 00000388 FFFF0378 
000003A0 FFFF0390 000003A8 FFFF0398 
000303C0 007703A8 000303C8 007803A8 
00030190 007B03E0 00030190 007C03E8 



0OOOE4A0 
0O0OE4C0 

O0O0E50O 
0000E520 
0OO0E540 
0000E560 

0OO0E5A0 
0O00E5C0 



OOOODEAO 
OOOOOECO 
OOOOOEEO 
OOOODFOO 
0OO0DF2O 
00O0OF40 
00O0DF60 
O0000F80 
OOCODFAO 
OOOODFCO 
OOOOOFEO 
DOOOEOOO 
OOOOE020 
00O0EO4O 
O0O0E060 
0OO0E08O 
OOOOEOAO 
OOOOEOCO 
OOOOEOEO 
OOOOEIOO 
O00OE120 
0O0OE14O 
00OOEI60 
0OOOE180 
OOOOEIAO 
OOOOEICO 
OOOOEIEO 
0OOOE2O0 
0OOOE220 
ODOOE240 
O0OOE26O 



rOOO^OOS 00100018 00200028 00300038 

''""" -■^900098 O0A000A8 00B000B8 

-/^aaX, O 100118 01200128 01300138 

(7 liaoil 80118011 80118011 

80218021 80318031 80318031 80318041 

80518051 80518051 80518001 80018001 

80018001 80018001 80018001 80018001 

80018001 80018001 80018001 03B103B9 

01790171 01A10199 01890015 00150015 

00150015 00150015 00150015 00150015 

00150015 00250025 00250025 00250025 

00250025 00250025 00250025 00250025 



00350035 00350035 00350035 00350035 00350035 

00350035 00350035 00350035 00350035 00350035 

00350035 00350035 00450045 00450045 00450045 

00450045 00450045 00450045 00450045 00450045 



00450045 00450045 00550055 00550055 
00550055 00550055 00550055 00550055 



OOOOOOOO 00000000 00000000 00000000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00000178 
00000180 
00000100 
OOOOOIFO 
00000210 
00000230 
00000250 
00000270 
00000290 
000002BO 
00000200 
000002 FO 
00000310 
00000330 
00000350 
00000370 
00000390 
00000400 
00030300 
00030190 



00010000 
00050000 
00090000 
OOOOOOOO 
00110000 
00150000 
00190000 
OOIOOOOO 
00210000 
00250000 
00290000 
00200000 
00840418 
FFFFOIBO 
FFFFOICO 
FFFFOIEO 
FFFF0200 
FFFF0220 
FFFF0240 
FFFF0260 
FFFF0280 
FFFF02A0 
FFFF02C0 
FFFF02E0 
FFFF0300 
FFFF0320 
FFFF0340 
FFFF0360 
FFFF0380 
FFFF03AO 
007903A8 
007D0188 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
OOOOOIAO 
00000180 
000001B8 
000001D8 
000001F8 
00000218 
00000238 
00000258 
00000278 
00000298 
0O0002B8 
000002D8 
000002 F8 
00000318 
00000338 
00000358 
00000378 
00000398 
000303B8 
00030400 
00030198 



.A.I.J.R...Z.1.9 



00060000 

OOOAOOOO 

OOOEOOOO 

00120000 

00160000 

OOIAOOOO 

OOIEOOOO 

00220000 

00260000 

002A0000 

00810410 

FFFF0400 

FFFF01A8 

FFFF01C8 

FFFF01E8 

FFFF0208 

FFFF0228 

FFFF0248 

FFFF0268 

FFFF0288 

FFFF02A8 

FFFF02C8 

FFFF02E8 

FFFF0308 

FFFF0328 

FFFF0348 

FFFF0368 

FFFF0388 

007603A8 

007A03A8 , 

007E03F8 J 



A 



T" 



}\ 



^^Ae^/^a^wL 



C^X 3o Mr)\ 



An example of dumping the page tables and low address storage on an event. 







Serviceability Aids. 2.97 



Trade Routines 

SDAIDS 



r 



St) 



EVENT ADDR OR PAGE ADOR 
NC-CLASS ♦CODE 
EVENT-ID PSW 

TE OSOOOO ^710200O0O(HI0EE 
IE <HF800 471D2000000410EE 
TE (HFOOO 47102000000410EE 
TE (HE800 471D2000000410EE 
TE 04E000 471D2000000410EE 
TE 04D800 471D2000000410EE 
TE 040000 471D20000004144C 
TE 060800 471D2000000422C8 
TE 042800 47101000000406EA 



TOD DEC MIC SEC 
2333039363651268 
2333039363711212 
2333039363794504 
2333039363852338 
2333039363912247 
2333039363969936 
2333039364088211 
2333039407337972 
2333039407342990 



EVENT MASKING 
PER LIMITS 
E GPRS LOWER UPPER 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 000000 FFFFFF 
0000 OOOOOO FFFFFF 
0000 OOOOOO FFFFFF 



GPR 13 
000402EO 
000402EO 
000402E0 
000402EO 
000402E0 
000402E0 
000402EO 
F6041E28 
F0040078 



GPR 14 
8004 108C 
8004 108C 
8004 1080 
8004108C 
8004108C 
8004108C 
80041414 
800405A6 
A004112E 



GPR IS 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
900417EC 
8004 114C 



GPR GPR 1 GPR2 
00000002 OOOOE003 0004102A 
00000002 0000E50A 00041E84 
00000002 000OD006 00041F04 
00000002 00000506 00042138 
00000002 OOOOC004 000422S0 
00000002 0OOOC5O2 000423SC 
00000002 0000B051 000424SE 
00000080 00040B1A 000403F4 
00040D78 00040B1A OOOOOOOl 



EVENT PGM CHK INTERRUPT TOD MICSEC 
GPR 0-7 OOOOOOIB 00040910 00000021 
GPR 8-F 00000000 00000000 00000000 
004000FF 00OOE640 FFFFFFFF 
OOOOFFFF 00000000 00000000 



CTL 0-7 

CTL 8-F 

LOH CORE 

00000000 

00000020 47100000 000422DC I471D3000' 

00000040 1000E718 08000000 1000E710 



00000000 00000000 00000000 



00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



000004AO 
000004C0 
000004EO 
00000500 
00000520 
00000540 
00000560 
00000580 
000005AO 



440COOOO OOOOOBCC OOOCOOOO 
00000S40 00000000 00020007 
00000000 00000000 20000060 
00000000 00000000 00000000 
— SAME — 

SUPERVISOR 

00000120 00000000 00000000 00000000 
— SAME — 

F1F261F0 F661F7F3 70007000 
00060FFF 0004232F 0004232F 
41044296 42974389 3F003F06 
46300000 30CC3E4C 3EBC0010 
OOOOOOOO 04A010EO 00000588 
00006140 00002ECA 080407CO 
00017000 08005DE6 0032002C 
60800800 000008FC 00009260 
OOOOOOOO 00007998 00006360 



2333039515946093 PSW AT TIME OF EVENT 471030000004 
00000002 0000002E OOOOOOOO OOOOOOOO OOOOOOOO 
4004007A 0004107A 07C8C1E2 A00406EE 000422A0 
FFFFFFFF OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOFFFFFF OOOOOOOO 00009000 C2000000 00000200 

^^ /^%>5- ■<JlM(. Ot.6 /'SW ^ 

OOOOOOOO^ OOOOOOOy 000004AO 40000000 OOOOOOOO 
000407181 OOOOOOOO 0003E974 470C2000 0000090C 
FC4F0500 023E32C0 440C0000 00000C14 
04080000 0000D13A 440C0000 OOOOOBIO 
12042003 00020000 OOOOOOOO OOOOOICC 
OOOOOOOO 00000100 OOOOOOOE OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



INSTR 



@M( 



O/o CiyaCK. ' e^/J- 



3C676CSEC 






OOOOOOOO 
0O03E8O0 

mi 
ooood 

OOOOOOOO 



-* 6 



9-oy/ ^ 



OOOOOOOO 

OOOOOOOO 
00000010 
3F0C38F1 
OOOOOOOO 
COC00340 
00004134 
00050000 
00005F78 
00003854 



n:-n>^fU'C^t^&n y^*i/9^Xr'^<if«a^ • 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO OOOOOOOO C2E4C707 D9C7C3D2 \.Z/Vlbm .BU6PRGCK 

OOOBFFFF FD7FCE03 3OAOCED0 002E40F0 ......L 

F2F0F6F7 F3F3F4F0 00003C04 0000003C 120673340. .. M. .. . 

00008090 00007118 00003864 3B045A30 N. . 

40404040 40404000 40404040 40404000 

000026C4 00004888 00005854 000082E8 ../ Y 

0000700C OOOOOOOO 00008299 000060B8 W -. 

00006068 000060CO 00000010 00007480 - -...-. 

00000638 00008099 00004246 00000760 - - /^ . 



An example showing the output to device X'OOE' (a line printer) after specifying 
a "dump on program check" and a page translation exception trace using output 
class FASTREC, AUTOMATIC 

Notice that the SD buffer is dumped before the dump of the supervisor and real 
storage. (A system dump would follow the SDAID dump if it was requested, refer to 
A-2 in this Section for a description of the system dump.) 



BHIF 
GP* 0- 
GPR 8- 
CTL 0- 
CTL 8- 
L3W CORE 
OOOOOOOO 
00000020 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



.000400C6) TOO MICSEC 

00333003 000404E8 00003FE0 

80041088 00041084 40041032 



^ 



2327688745012422 
000407A1 00000004 
00040088 00041888 
FFFFFFFF 00030000 
00040660 OOOOOOOO 



OOOOOOOl 00000006 
00042888 000004AO 
OOOOOOOO OOOOOOOO 
OOOOOOOO C2000000 



PSW 470D000000040E78 INSTR .47F0BDFqft7F0 
80041BQ0 
00000540 
OOOOOOOO 
00000200 



Coule, 



00008CA0 OCOOOOOO 00003860 
440:0000 00000C4E OOOCOOOO 
00393540 00000080 00020040 
OOOOOOOO OOOOOOOO 20000060 
OOOOOOOO OOOOOOOO OOOOOOOO 
— SAME — 
COMREG LOC 000004AO 
000004AO F1F051F0 F561F7F3 70007000 
000004CO 00088FFF 00042D1B OOOOOOOO 
000004EO 3F3841A6 41 A7 4299 3D003DD6 
00000500 45400000 3B9C3C1C 3C8C0010 
00000520 OOOOOOOO 04A010E0 00000588 
00000540 000063E8 00002BFE 083607F0 
00000560 00017000 0700608E 0032002C 
SYSCOM LOC 00000540 
00000540 000063E8 00002BFE 083607FO 
00000560 00017000 0700608E 0032002C 
00000580 60800840 00000952 00009488 
C00005A0 0000063C 00007D40 00006608 
000005CO 00003156 OO00A264 00 0006E4 
000005EO 00081018 00200000 OOOOOOOO 
00000500 OOOOOOOO OOOOOOOO OOOOOOOC 
00000620 00005580 OOOOOOOO 00002972 
00000640 OOOOOOOO OOOOOOOO 00003CD0 



OOOOOOOO 
00043E78 
OOOOOOOO 
O003B000 
00040380 
000002CO 
OOOOOOOO 



OOOOOOOO 
00300010 
30DC38F1 
00003300 
COC00740 
00004300 
00050000 

00004000 
00053000 
0000622 
00003594 
OOOOOOOO 
OOOOOOOO 
01710001 
0003FFFF 
000038C6 



OOOOOOOO 
00003000 
FD083E00 
04080000 
12042803 
OOOOOOOO 
OOOOOOOO 



OOOOOOOO 
OOOFFFFF 
F0F0F5F7 
000084BC 
40404040 
00009AOO 
000072B4 

00009AOO 
000072B4 
00006310 
00000560 
0000D960 
OOOOOOOO 
0000F500 
000086C8 
OOOOOOOO 



000004A0 
00000300 
02583606 
00038188 
OO02C000 
00000100 
OOOOOOOO 



471D1000 
470F2000 
440COOOO 
44 OC 0000 
000400C6 
00000130 
OOOOOOOO 



000 4047 A 
00300962 
O0OO0CC8 
00000B92 

oooooi:8 

OOOOOOOO 
OOOOOOOO 



OOOOOOOO 02C50561 E3D604E2 
FD7FFED3 3000FEDO OOC63F01 
F3F2F7F8 00003AA4 0000003C 
000074B8 000035A4 39A45C04 
40404000 4040 4040 40404000 
00004798 00005AF8 000087C0 
OOOOOOOO 0000875A 00006360 



00004798 
OOOOOOOO 
00006368 
000084C5 
00009088 
000036 72 
0000ED38 
AOOE8000 
OOOOOOOO 



OOOOSAFB 
0303876A 
00000010 
0000414A 
00003838 
OOOOOOOO 
0000F160 
OOOEFOOO 
00000680 



00O087C0 
00006350 
00007850 
00000790 
OOOOOOOO 
OOOOOOOO 
00006620 
OOOOOOOO 
07241054 






Off Oi ■nt/xl 



10/05/73 KEN/TOMS 

L F.J 

.0 0... 100573278 



(exlfHT) 



An example of dumping the active communication region and low address 
storage on an event. 



2.98 Serviceability Aids. 



Trace Routines 

SDAIDS 



o 



o 







^HH 


n 




BHH 






■■■1 


■ 




^ // JOB DEBUGEXl 
• // OPTION NODECK.LIST, 
// EXEC ASSEMBLY 

^ PAGENQ PAGE 00040800 


XREF, LINK. LOG. OUNP 

KEY 1 TASKIO 1 


REQUIO 03 


DATE 
TFIX 


2/06/73. CLOCK 11/49/33 


y- 


1 




^ PAGEHOL 


PAGE 00040800 


FRAME 


00018800 KEY I TASkIO 1 


REQUIO 03 


TFIX 


'^yU<^n^ 


H 




PAGENQ 


PAGE 00041000 




KEY 1 TASKIO 1 


REQUIO 03 


TFIX 




a^ux 


H 




• PAGEHOL 


PAGE 00041000 


FRAME 


00019000 KEY 1 TASKIO 1 


REQUIO 03 


TFIX 




^1 




^ PAGENQ 


PAGE 00041800 




KEY 1 TASKIO 1 


REQUIO 03 


TFIX 


t.. ^ 


H 




PAGEHOL 


PAGE 00041800 


FRAME 


00019800 KEY 1 TASKIO 1 


REQUIO 03 


TFIX 


oCu^/t/n^ oin / 


U^OptM^ 


H 




• PAGENQ 


PAGE 00042000 




KEY 1 TASKIO 1 


REQUID 03 


TFIX 




u 


H 




^ PAGEHOL 


PAGE 00042000 


FRAME 


OOOIAOOO KEY 1 TASKIO I 


REQUIO 03 


TFIX 






H 




PAGENQ 


PAGE 00042800 




KEY 1 TASKIO 1 


REQUID 03 


TFIX 






H 




• PAGEHOL 


PAGE 00042800 


FRAME 


00018000 KEY 1 TASKIO 1 


REQUID 03 


TFIX 






H 




^ PAGENQ 


PAGE 00043000 




KEY 1 TASKIO 1 


REQUIO 03 


TFIX 






H 




PAGEHOL 


PAGE 00043000 


FRAME 


00017800 KEY 1 TASKID 1 


REQUIO 03 


TFIX 






H 




• PAGENQ 


PAGE 00043800 




KEY 1 TASKIO 1 


REQUIO 03 


TFIX 






H 




^ PAGEHOL 


PAGE 00043800 


FRAME 


0001A800 KEY 1 TASKID 1 


REQUIO 03 


TFIX 






H 




PAGENQ 


PAGE 00044000 




KEY 1 TASKIO 1 


REQUID 03 


TFIX 






H 




• PAGEHOL 


PAGE 00044000 


FRAME 


OOOIBOOO KEY 1 TASKIO 1 


REQUID 03 


TFIX 






H 




^ TE PAGE 


AODR 00050000 


TOD 


MICSEC 2333011788410161 


PSH AT TIME OF EVENT 


4710200000041632 INSTR 92FF2002943F 




H 




PAGENQ 


PAGE 00050000 




KEY 1 TASKIO 1 


REQUIO 10 


TE 






H 




• PAGEHOL 


PAGE 00050000 


FRAME 


0001B800 KEY 1 TASKIO 1 


REQUIO 10 


TE 






H 




^ TE PAGE 


AOOR OOOSFOOO 


TOO 


MICSEC 2333011788621154 


PSM AT TIME OF EVENT 


471000000004166E INSTR 0706A000A000 




H 




PAGENQ 


PAGE O0O5F0O0 




KEY 1 TASKID 1 


REQUIO 10 


TE 






H 




• PAGEHOL 


PAGE OOOSFOOO 


FRAME 


OOOICOOO KEY 1 TASKIO 1 


REQUID 10 


TE 






H 




^ TE PAGE 


AOOR 0005F800 


TOO 


MICSEC 2333011790227387 


PSW AT TIME OF EVENT 


4710300000040644 INSTR 0EEOOS01O686 




H 




PAGENQ 


PAGE 0005F800 




KEY 1 TASKIO 1 


REQUIO 10 


TE 






H 




• PAGEHOL 


PAGE 0005F8O0 


FRAME 


0001C800 KEY 1 TASKIO 1 


REQUIO 10 


TE 






H 




^ TE PAGE 


AOOR 00060000 


TOO 


MICSEC 2333011793770641 


PSH AT TIME OF EVENT 


4710300000040644 INSTR OEE005010686 




H 




PAGENQ 


PAGE 00060000 




KEY 1 TASKID 1 


REQUID 10 


TE 






H 




• PAGEHOL 


PAGE 00060000 


FRAME 


OOOIDOOO KEY 1 TASKIO 1 


REQUID 10 


TE 






H 




_ TE PAGE 


AOOR 00060800 


TOD 


MICSEC 2333011796139258 


PSW AT TIME OF EVENT 


4710300000040644 INSTR 0EE005010686 




H 




PAGENQ 


PAGE 00060800 




KEY 1 TASKIO 1 


REQUIO 10 


TE 






H 




• f^AGEHDL 


PAGE 00060800 


FRAME 


0001D800 KEY 1 TASKIO 1 


REQUID 10 


TE 




C£>^Z9/fT) 


H 




HUH 


HIH 


n 




■■■ 






■■■ 


1 



An example of SDAID page tracing during an assembly job. 



^I^HH^H 






■|H|H||HH 


■ 


■ 










■|HM 






^HBH 


H^H|MH|HH 


HH^H 


EVENT AODR OR PAGE AODR 


^^^^^H 


1 


■ 


EVENT MASKING 




^^™ 






^^™ 


^^^^^* 


• HC-CLASS ♦CODE 






PER 


LIMITS 














EVENT-ID 


PSW 


TOO DEC MICSEC 


TE 


GPRS 


LOWER 


UPPER 


GPR 13 


GPR 14 


GPR 15 


GPR 


GPR 1 


GPR2 


_ TE 


043000 


470000000004 1C62 


2333035396598690 


Y 





0000 


000000 




00042888 


000004AO 


00000760 


00000003 


000O3F0C 


0000410C 


• TE 


OSDOOO 


4710200000041632 


2333035416187226 


Y 





0000 


000000 




000402E0 


00O414F8 


00060FFE 


80041934 


00040C20 


00050507 


TE 


05F000 


471D00000004I66E 


2333035416192369 


V 





0000 


000000 




000402EO 


80041646 


0005F2S5 


80041934 


00040C20 


00040A7F 


A TE 


05F800 


4710300000040644 


2333035417576315 


Y 





0000 


000000 




00040 2E0 


0005F7FD 


00000019 


0005F255 


00000019 


00040839 


• TE 


060000 


4710300000040644 


2333035420950387 


V 





0000 


000000 




000402EO 


O0O5FFEA 


OOOOOOIF 


0005F255 


OOOOOOIF 


00040B3F 


TE 


060800 


4710300000040644 


2333035423146414 


Y 





0000 


000000 




00040 2E0 


000607F4 


0000003F 


0005F255 


0000003F 


0005F289 


_ TE 


059800 


4710200000041E2C 


2333035449944730 


Y 





0000 


000000 




000402EO 


00040FS8 


0005F255 


00040 A TO 


000S9B41 


0000 1C7E 


• TE 


057800 


471020000004 1E6E 


2333035449949477 


V 





0000 


000000 




000402EO 


00040F58 


000SF255 


00040A7C 


00001C7E 


00059832 


TE 


05B800 


4710300000040644 


2333035453007449 


Y 





0000 


000000 




000402EO 


0005B7EE 


00000039 


0005D447 


00000039 


00000004 


A TE 


OSCOOO 


4710300000040644 


2333035453671223 


Y 





0000 


000000 




000402EO 


000SBFF6 


00000021 


00050447 


00000021 


00000005 


• TE 


0SC800 


4710300000040644 


2333035454009747 


V 





0000 


000000 




000402EO 


0005C7CA 


00000046 


00050447 


00000046 


00000005 


TE 


050800 


47102000000410EE 


2333035623279245 


Y 





0000 


000000 




000402EO 


8004108C 


00041AF4 


00000002 


0000F504 


00041804 


A TE 


050000 


4710200000 0410EE 


2333035623336942 


Y 





0000 


000000 




000402EO 


8004 10 8C 


00041AF4 


00000002 


OOO0E003 


0004 102A 


• TE 


04F800 


47102000000410EE 


2333035623396991 


Y 





0000 


000000 




00040 2E0 


8004108C 


00041AF4 


00000002 


0000E50A 


00041E84 


TE 


04F00O 


47102000000410EE 


2333035623480401 


V 





0000 


000000 




000402EO 


8004 108C 


00041AF4 


00000002 


00000006 


00041F04 


_ TE 


04E800 


471D2000000410EE 


2333035623538305 


Y 





0000 


000000 




060402E0 


8004108C 


00041AF4 


00000002 


00000506 


00042138 


• TE 


O4E0OO 


471020000004 lOEE 


2333035623598321 


Y 





0000 


000000 




000402EO 


8004 108C 


00041 AF4 


00000002 


OOOOC004 


00042250 


TE 


040800 


471020000004 lOEE 


2333035623656083 


Y 





0000 


000000 




000402E0 


8004 108C 


00041AF4 


00000002 


O0O0C5O2 


0004235C 


A TE 


04D0OO 


471D20000004144C 


2333035623774539 


V 





0000 


000000 




000402EO 


80041414 


00041AF4 


00000002 


O0OOBO51 


0004245E 


• TE 


060800 


47102000000422C8 


2333035667085247 


Y 





0000 


000000 




F6041E28 


800405A6 


900417EC 


00000080 


00040B1A 


000403F4 


TE 


042800 


47101000000406EA 


2333035667090270 


Y 





0000 


000000 




F0040078 


A004112E 


80041 14C 


00040078 


00040B1A 


00000001 


A TE 


043000 


4700000000041C62 


2333035783718692 


Y 





0000 


000000 




0004Z888 


000004AO 


00000760 


00000003 


00003FOC 


0000410C 


• SOBUFFER END 


■HH 


1 


1 


■ 








m 






HH 


(€x.z4^ 



OA dump of the SD buffer after executing a page trace (TE) using the FASTREC 
output class. (The SD buffer is dumped on termination of SDAID). 




Serviceability Aids. 2.99 



Trace Routines 

SDAIDS 







IHHII 


■ 






■ 


■ 


■ 




■HHH 


■i 


hhup 


■ 


■■■ 






^ IF GA 


000404 3C 


TOO 


JbcSEC 2333012672382809 


PSM 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 






BRIF 


0004043E 


TOO 


MlVsEC 2333012672458551 


PSH 


AT 


TIME 


OF 


EVENT 


471D000000040448 


INSTR 


4780B3CE0630 








• IF G* 


P0040448 


TOD 


MIc\eC 2333012672534442 


PSW 


AT 


TIME 


OF 


EVENT 


47100 0000004044A 


INSTR 


12444780B3DA 








_ BRIF 


00C4044A^ 


TOO 


MICsVc 2333012672610919 


PSW 


AT 


TIME 


OF 


EVENT 


471D000000040454 


INSTR 


4780B30A0640 








IF GA 


00040454 \ 


k TOD 


HICSEA 2333012672685341 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


12554780B3E6 








• IF 


00040456 


\ou 


HICSfccX 2333012672761969 


PSH 


AT 


TIME 


OF 


EVENT 


47I020000004045A 


INSTR 


4780B3E60650 








_ IF GA 


0004045A 


'\ 


MICSEC \2333012672838460 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0B3C2 








BRIF 


n004045C 


TOD^ 


^ICSfcC 1333012672913531 


PSW 


AT 


TIME 


OF 


EVENT 


471U2000000404BC 


INSTR 


47F0B3C21266 








• IF GA 


0004043C 


TOO 


\cSEC 2*33012672990157 


PSW 


AT 


TIME 


OF 


EVENT 


471U00000004043E 


INSTR 


12334780B3CE 








^ BRIF 


C0C4043E 


TOD 


MlJ^EC 23B3012673065877 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








IF GA 
• BRIF 
« IF GA 


C0040448 

0004044a)s^ 

0^040454 


TOD 

Tno 

X 


MICSEC 2 3 3B0 126 73 140296 
HICSeX 2331012673216921 
Ml CSEc\ 2 »33B 12673293403 


PSW 
PSW 
PSw 


AT 
AT 
AT 


TIME 
TIME 
TIME 


OF 
OF 
OF 


EVENT 
EVENT 
EVENT 


471D00000004044A 
471D000000040454 
471D200000040456 


INSTR 
INSTR 
INSTR 


12444780b3DA 


BZ cutfiks 
UTR 6. 5 




4 780B3D<i0640 


1255|4780B3E6 




IF 


00040456 


TOO 


mK^EC \3334l2673368510 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


47B0B3E^650 


pz CLe/mi 






• IF GA 
^ BRIF 


0004045A 
0004045C 


TOO 
TOO 


MicseV 2X330*2673445086 

HI \ \ I '^ 


PSw 

PSW 


AT 
AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


471O200O0004O45C 
471020000004043C 


INSTR 
INSTR 


'0650|47FOB3C2 


B CLIAR 1 




47F0B3C2|1266 




IF GA 


000404 3C 


TOO 


H, \\ 1 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


|1233|4780B3CE 


LTfi. 3,3 






• BRIF 


C004043E 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


|478OB3Ce|063O 


SZ CiCfidCf- 






_ IF GA 


C004044B 


/^O 


^ffB^ tm 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004044A 


INSTR 


|1244'4780B3DA 


kTfi U-.q. 






BRIF 


C004044A^ 


TOO 


Ml / 19 


PSw 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


|4 7S0H30A)0640 


e>z c LeflR 5 






• IF GA 


00040454 


TOO 


Ml /Xi^ aJi/f^W n 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 








• IF 


03040456 


T'lO 


Ml 52 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 








IF GA 


0004045A 


TOO 


MI 31 
ML^^W ^TUC£, 16 


PSW 


AT 


TIME 


OF 


EVENT 


471(J20000004045C 


INSTR 


065047F0B3C2 








• BRIF 


0004045C 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


47ID20000004043C 


INSTR 


47F0B3C21266 








_ IF GA 


0O0404 3C 


TOO 


PSw 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


123347808 3CE 








BRIF 


O-104043E 


.,/ 


MI,. 96 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








• IF GA 


00040448 


A 


PSW 


AT 


TIME 


OF 


EVENT 


47ID00000004044A^ 


INSTR 


12444780B3DA 








^ BRIF 


0004044 A^ 


^ — 

TOO 


MICSEC 2333012674430955 


PSw 


AT 


TIME 


OF 


EVENT 


4710000000040454 


INSTR 


4780B3DA0640 










IF 


00040454 


no 


MICSEC 2333012879517750 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


125547B08 3E6 










• IF 


rO040456 


TOD 


MICSEC 2333012879592055 


PSw 


AT 


TIME 


OF 


EVFNT 


471020000004 045A 


INSTR 


4780B3E60650 










• IF 


n004045A 


TOD 


MICSEC 2353012879663631 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 










BRIF 


0004045C 


TOD 


nir<;Fr 731301 7R79745185 
M ficU*^ ^/y^ ,57 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004043C 


INSTR 


47F0B3C21266 










• IF 


0n04043C 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


1233478063CE 


/9 


/J 






_ SRIF 


0004043E 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 


/?/C Y- 












M - ^o^'^ft _ ;;; 










* 








//^ 






IF 


00040448 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004044A 


INSTR 


12444780B3DA 






• BRIF 


0004044a) 


TOO 


3B0Z ,, 


PSW 


AT 


TIME 


OF 


EVENT 


471D000000040454 


INSTR 


47eOB3DA0640 


/roxui^ 






• IF 


00040454 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


12554780B3E6 










IF 


00040456 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 










• IF 


0004045A 


TOO 


M -fccc^ '-'*'* 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F08 3C2 










^ BRIF 


0004045C 


TOD 


MlCbtC 23330l28aU35 J883 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004043C 


INSTR 


47F0B3C21266 










IF 


000404 3C 


TOD 


MICSEC 2333012680427507 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 










• BRIF 


0004043E 


TOO 


MICSEC 2333012880501878 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 




' (gxSi Hf) 








HHH 








■ 


■ 


■ 




HHHH 


H 


HHi 


HHI 





o 



W^ M 



This example shows an SDAID BR, IF and GA trace used to trace a loop using 
output class PSW. 

The GA trace was "taken off" by changing the contents of control register 9, and the 
programmers remarks on this example show how the information is interpreted. 
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The label information cylinder is on the first full cylinder after the last system 
library on SYSRES. A display of all labels on the cylinder, with the exception of 
Data Set Secured labels, can be obtained by executing LSERV. Illustrations in this 
section show the location of the label information cylinder on SYSRES, and the 
layout of label information and record format. 



System requirements 

LSERV may be executed in any partition, with a minimum of 8192 bytes of the 
real or virtual address areas. LSERV assumes that the SYSRES label cylinder is 
formatted as described in DOS/ VS DASD Labels. 



Executing LSERV 

The control statements necessary to execute LSERV in a virtual partition are: 

From the console: 

// EXEC LSERV 

From the reader: 

// JOB jobname 
//EXEC LSERV 

r 
/& 

LSERV can also be executed in a real partition. The output of LSERV shows the 
contents of the label cylinder on the device assigned to SYSRES. The output is 
directed to the device assigned to SYSLST. 



When and How to use 

1 . Operator action given in DOS/VS Messages indicates when LSERV must be 
executed. 

Programmer action, also given in DOS/VS Messages, explains how to use the 

LSERV printout. 

For example, under the message: 

0P36NO REC FND 

2. It is useful to execute LSERV prior to running a program that is known to have 
been run sometime in the past, but whose workfile assignments and partition 
allocations are unknown. 

3. LSERV can be used for error analysis. LSERV displays the TLBL and the DLBL 
and EXTENT information contained on the SYSRES label cylinder . Information 
about secured data files is not displayed. 



/f' A 



Summary of information provided 

The printout of LSERV will show you the following details about the previous run: 

• Whether the correct DLBL/EXTENT information is still on the label cylinder 

• The permanent files 

• The temporary files 

• Extent type 

• File type. 

An example shown at the end of this chapter relates the data printed by the LSERV 
program to the DLBL/EXTENT job control statements. 
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*% 



The Label Information Cylinder 



Library Display Programs and Utilities 

LSERV 



The label information cylinder contains standard and user label information for 
background and foreground partitions. 

19 tracks on the 3330/3333, 12 on the 3340, or 20 on the 2314/2319 are allocated 
to the label information cyhnder. 

The purpose of the label cylinder is to enable label information to be placed in the 
label save areas during program execution. 

Job control stores label information, which is contained in the input job stream, 
on the label cylinder. 

During program execution, label information on the label cyHnder is used by the 
OPEN and CLOSE routines. 



jT^-^ 
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SAMPLE JOB STREAM 

//JOB CATALOG USER PROGRAM 
//OPTION CATAL 

[Object module preceded 1 
by PHASE and INCLUDeJ 

1 /• 
// LBLTYPNSD (01) 

2 //EXECLNKEDT 
/& 

// JOB EXECUTE USER PROGRAM 
//DLBL 



// EXTENT 

//DLBL 

// EXTENT 

//TLBL 

// ASSGN 

//ASSGN 

//ASSGN 

// EXEC USER 

/& 



File 1 (Seq. Disk) 



File 2 (Nonseq. Disk) 

File 3 (Labeled Tape) 

Filel 

File 2 

Files 



Sequence of Events 

1 LBLTYP reserves label area in virtual storage 
for longest label block 

2 Link edit and catalog user phase to core 
image library 

3 Write label information to label cylinder 

4 Assign user files 



Bring program into virtual storage and process 
OPEN/CLOSE 

a. Bring label storage data into virtual storage 

b. Bring file labels into virtual storage 

c. Compare input, create new output labels 



An overview showing how DOS/VS uses 
the label information cylinder. 




SYSRES 



Label 

Information 

Cylinder 



Supervisor 



Seq. 
Disk 



Transient Area 



Label Area 

Nonseq. Disk and Tape 



Background Partition 
USER Program 

Open all 3 

Ooseall 3 



Virtual 
Storage 
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-W 



NO. 




nnMPnMFMT 


STARTING DISK ADDRESS 


NUMBER 
OF TRACKS 

(Allocation) 


R = REQUIRED 




BB 


CC 


HH 


R 


= OPTIONAL 


1 


IPL Bootstrap Record 1 ($$A$IPL1) 


00 


00 


00 


' 


1 


R 


IPL Bootstrap Record 2 ($$A$IPL1) 


00 


00 


00 


2 


R 


Volume Label 


00 


00 


00 


3 


R 


User Volume Label 


00 


00 


00 


4 





2 


System 
Directory 


Record 1 


00 


00 


01 


1 


1 


R 
R 
R 
R 


Record 2 


00 


00 


01 


2 


Record 3 


00 


00 


01 


3 


Record 4 


00 


00 


01 


4 


IPL Retrieval Program ($$A$IPL2) 


00 


00 


01 


5 


R 


3 3 


Core Image Library Directory 


00 


00 


02 




* 


R 


4 


Core Image Library 


00 


End of CI Directory 




♦ 


R 


X 1 Y + 1 ^ 


5 


Relocatable Library Directory 


00 


End of CI Directory 




* 





Z + 1 


00 


6 


Relocatable Library 


00 


End of RL Directory 




* 





X 


Y + 1 


7 


Source Statement Library Directory 


00 


End of RL Directory 




* 





Z + 1 


00 


8 


Source Statement Library 


00 


End of SS Directory 


'I 


* 





X 


Y + 1 


9 


Procedure Library Directory 


00 


End of SS Directory 




* 





Z + 1 1 00 


10 


Procedure Library 


00 


End of PL Directory 




* 





X 


Y + 1 


11 




00 


End of P Library 




* 





Label Information Cylinder 


Z + 1 


00 



•Allocation Dependent On User Requirements 
X = Ending CC of the Proceeding Directory 
Y = Ending HH of the Proceeding Directory 
Z = Ending CC of the Proceeding Library 

The location of the label information cylinder on the SYSRES extent 



^,-y 



c 
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DISK PACK TYPE 



For a 1 partition system, information on 
tracks 2, 3, 4 and 5 is ignored, and for 
a 2 partition system tfie tracks for the 
F1 partition follows BG and information 
on tracks 4 and 5 is ignored 



3340 



2314 

or 
2319 



3330 

or 

3333 



TRACK ALLOCATION 
for a 1 , or 2, or 3, partition system. 
(First Full Cylinder after Last Library on SYSRES) 
Track 

BG (USRLABEL) * | Temporary 

BG (PARSTD) [ standard (Permanent) 

F2 (USRLABEL) * | Temporary 

^Standard (Permanent) 



LSERV 



F2 (PARSTD) 



F1 (USRLABEL) * | Temporary 



F1 (PARSTD) 



- (STD LABEL) ! 

7 P" Standard Labels ] 

1 — ^°^ ^" 1 

° I — partitions ' 

10 



Standard (Permanent) 
^ 



11 



12 
13 
14 
15 
16 
17 
18 



lAdditional Standard Labels! 



19 



3 




y Standard (Permanent) 



]; 



O 



TRACK ALLOCATION 
for a 4 partition system 

Track 



TRACK ALLOCATION 
for a 5 partition system 






BG (USRLABEL) 


* 1 


1 


BG (PARSTD) 1 


2 


F3 (USRLABEL) 


M 


3 


F3 (PARSTD) 


4 


F2 (USRLABEL) 


« 1 






5 


F2 (PARSTD) 1 






6 


F1 (USRLABEL) 


•1 


7 


F1 (PARSTD) 


8 


Standard for all | 


9 


Partitions | 


10 


1 


11 


1 


12 


1 


13 


1 


14 


Additional Standard Labelsj 


15 


1 


16 




^' 


1 


18 




1 


19 





Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 
Temporary 
Standard (Permanent) 



/-Standard (Permanent) 



Track 






BG 


(USRLABEL) 


H 


1 


BG 


(PARSTD) 


i 


2 


F4 


(USRLABEL) 


M 






3 


F4 


(PARSTD) 








4 


F3 


(USRLABEL) 


M 


5 


F3 


(PARSTD) 


i 






6 


F2 


(USRLABEL) 


*l 


7 


F2 


(PARSTD) 




8 


F1 


(USRLAB€L) 


* 1 


9 


F1 


(PARSTD) 


1 


10 


\ 


11 




12 


1 


13 


! 


14 


Additi 


onal Standard Labels! 


15 


! 






16 


1 


17 


1 


18 




19 









Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 

Temporary 

Standard (Permanent) 



> Standard (Permanent) 



* Label sets submitted in a job stream 
without a // OPTION PARSTD,STDLABEL 
are written to the temporary area for the 
partition being used. 



Track allocations of the Label Information Cylinder for a 1, 2, 3, 4, and 5 partition system. 
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Job Control Statements or Operator Initiation Commands 




//TLBL 



Label 

Information 

Cylinder 







^ 








//TLBL 










\ 




//VOL 






//TPLAB 


^ 






/ 


/ 






^ 




Byte 


Filename 


Auxiliary 
»yt« 


File 
ID 


File 

Serial 

Number 


Volume 

Sequence 

Number 


File 

Sequence 

Number 


Generation 
Number 


Version 
Number 


Creation 
Date 


Expiration 
Date 


Fife 

lSe<J«rlty 


Block 
Count 


StV8t«nfi 


Flag 
Bytes 


1 


7 


1 


17 


6 


4 


4 


4 


2 


6 


6 


1 


6 


13 


2 


c 


) > 




1 


8 


9 


26 


32 


36 


40 


44 


46 


52 


58 


59 


65 


78 






— ni< 


nianpmpnt in virtiinj stnranf 









Format and contents of the label information cylinder for tape labels 

(Shaded areas are not processed by DOS/VS Logical IOCS) 
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1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


131415 


16 


17 


18 




13 


Field 


1- 
z 
uu 

1- 
x>_ 

LLI O 

C0.° 
_JX! 

0£ 


Filename 


u 

1 

< 

< 

Q 


File ID 


Q 

o 
u. 


File 

Serial 

Number 


6 

z 

d- 

0} 
CO 
a> 

E 

3 


0) 
(0 

Q 

c 
g 

CO 

6 


TO 

Q 

c 
o 

"■!-< 

s 

■q. 

X 

UJ 


"D 


8 

c 

a 
O 


System 
Ctode 


Volume 

Serial 

Number 


0} 

a. 
> 

h- 
*-> 

c 

Si 

X 

UJ 


o 

z 

cr 

(U 
CO 

c 

X 

UJ 


Extent 
Lower 
Limit 


Extent 
Upper 
Limit 


5 
o 

■Q in 

u 

CO T3 

8< 
35 


g 

CN 
CO 
CM 


<u 
a 
a 

D 

cvi 

CO 
CN 


Ar^other 
Extent if 
DAM. 
ISAI« or 
VSAM 


1 


7 


1 


44 


1 


6 


2 


3 


3 


2 


1 


13 


6 


1 


1 


4 


4 


2 


1 


1 


Bytes 


o 


"^ 


00 


O) 


CO 


s 


8 


s 


to 


s 


o 


r^ 


00 


§ 


5) 


CN 


CD 


8 


CN 
O 


CO 

o 


Displacement 



LSERV 




Field 



Name 



1. DLBL-EXTENT 



Description 

SAM 

Bit 0: 1 = Next extent on a new pack. 

Bit 1 : 1 = Last extent. 

Bit 2: 1 = Bypass extent. 

Bit 3: 1 = New volume on same unit. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 

Bit 6: 1 = No EXTENT /XTENT card. 
Bit 7: 1 = Unused. 
DAM, ISAM, or VSAM 
Number of extents. 



Field 



Name 



12. System Code 



Description 

Initialized to contain one character 
string IBMDOSVS. This field is not 
processed by DOS/VS. 



13. Volume Serial No. Volume serial number for extent. 



14. Extent Type 



2. 
3. 



Filename 



DAM/ISAM Switch 






4. File ID 



5. Format ID 

6. File Serial No. 

7. Volume Seq. No. 

8. Creation Date 

9. Expiration Date 

1 0. Reserved 

1 1 . Open Code 



Bits 0-3: Unused. 

Bit 4: 1 = Extent limits omitted. 

Bit 5: 1 = Extent converted to DASD 

address. 
Bits 6& 7: Unused. 

File identifier including generation 
and version numbers. If field is 
missing on DLBL card. Filename 
padded with blanks is inserted. 
This field is not used when a 
VSAM data space or Unique file 
is defined. Also, filename is not 
substituted for file-l-D with 
VSAM 

Numeric 1 is inserted. 

Volume serial number from first 
extent. 

Always initialized to X'OOOI'. 

Initialized with 3 bytes of X'OO'. 

If date is in the form YYDDD, it is 
converted to YDD. If date is in re- 
tention period form, 1 to 4 characters, 
the field is padded with binary zeros. 

The retention period, if specified is 
converted to a 2-byte number and 
inserted in this field. 

DLBL type: 

S = SAM 

D= DAM 

A= VSAM 

C or E = ISAM System where: 

C = Load create function 

E = Load extend function 



15. Extent Seq. No. 



16. 
& 
17. 



Extent Lower 
and Upper 
Limits 



Same codes as in Format-1 label: 
X'OO' = Next three fields do not 

indicate any extent. 
X'Or = Prime data area ISAM, data 
area (SAM, DAM) or data 
space (VSAM), (that is the 
extent containing the user's 
data records). 

X'02' = Overflow area of an ISAM 

file. 
X'04' = Cylinder index or master 

index of an ISAM file. 
X'40' = User label track area. 
X'8n' = Shared cylinder indicator, 

where n = 1 ,2, or 4. 

Number of extent as determined by 
the extent card sequence. 

Before the OPEN, DLBL/EXTENT 
information is in the relative track 
form of HHNNT followed by three 
bytes of binary zeros. 
HH = Relative (to 0) start address in 

tracks. 
NN = Number of tracks. 
T = or upper track number for 

split cylinder in SAM files. 
Following an OPEN on DLBL/ 
EXTENT cards, or whenever DLAB/ 
XTENT cards are used, the extent 
lower and upper limits are each in the 
CCHH format. 



18. Logical (Symbolic) This 2-byte field identifies the logical 
unit with the same code as that used 
in a CCB. The first byte identifies the 
unit class: 

X'OO' = System Logical Unit 
X'01' = programmer Logical Unit 
The second byte identifies the logical 
unit within its class. 



Thus X'0003' denotes SYSLST and 
X'01 03' denotes SYS003. 

2321 extent lower and upper cell 
limit. This 2-byte field contains zeros 
for disk devices. 



Unit Address 



19. 



2321 Lower Cell 
2321 Upper Cell 



o 



NOTE: For SAM files, a complete 104-byte block is repeated for each new EXTENT. 

For DAM, VSAM, and ISAM files, only fields 1 3 through 1 8 are repeated for each EXTENT. 

Format and contents of the label information cylinder for DASD and DISKETTE labels. 
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An example of some of the output to a line printer after executing th^ LSERV program, part 1 , 
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■ 


■ 


■ 




IHHHIH 


EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

• EXTENT TYPE 

EXTENT LIMITS OMITTED 
SYMBOLIC UNIT 

• VOLUME SERIAL NUMBER 










00 

1 (PRIME DATA) 

SYSRDR CCB FORMAT 0000 
OMITTED 


1 




Fl USER LABELS (TEMPORARY PER PARTITION) TRACK 


8 






1 




• NONE 












H 




• Fl PARTITION STANDARD LABELS (PERMANENTI TRACK 


9 






H 




^ IJSVSIN 

• FILE IDENTIFIER 
FILE SERIAL NUMBER 

_ VOLUME SEQUENCE NUMBER 

• CREATION DATE 
RETENTION PERIOD (DAYS! 

_ FILE TYPE 










SYSRDRIO 

OMITTED 

01 

OMITTED 

0007 

SEQUENTIAL 


1 




EXTENT INFORMATION 
^ EXTENT SEQUENCE NUMBER 

• EXTENT TYPE 

EXTENT LIMITS OMITTED 
_ SYMBOLIC UNIT 

• VOLUME SERIAL NUMBER 










00 

1 (PRIME DATA) 

SYSRDR CCB FORMAT 0000 
OMITTED 


1 




STANDARD LABELS (ALL PARTITIONS-PERMANENT) 


TRACKS 


10-19 FOR 2314,10-18 FOR 3330, OR 10-11 FOR 33*0 


■ 




• IJSYSRS 

FILE IDENTIFIER 
FILE SERIAL NUMBER 

V VOLUME SEQUENCE NUMBER 
CREATION DATE 

^ EXPIRATION DATE 

• FILE TYPE 










DOS.SYSRES.FILE 

111111 

01 

OMITTED 

99/365 

SEQUENTIAL 


1 




_ EXTENT INFORMATION 

• EXTENT SEQUENCE NUMBER 
EXTENT TYPE 

^ RELATIVE (TO ZERO) START ADDRESS 

• NUMBER OF TRACKS 
SYMBOLIC UNIT 

3 VOLUME SERIAL NUMBER 

a* 


IN 


TRACKS 


01 

1 (PRIME DATA) 

0001 

3959 

SYSRES CCB FORMAT 0006 

mill 


1 




^ IJSYSLN 
_g___ FILE IDENTIFIER 




■ 


■ 






^J3AHr)^^M 








1 


■ 

DOS 


LABEL CYLINDER DISPLAY 






STAND 

FILE IDENTIFIER 

• FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 

• EXPIRATION DATE 
FILE TYPE 










COMPARE-FILE FOR TESTCASE0UTPU1 

TESTVl 

01 

OMITTED 

69/001 

DIRECT ACCESS 






• EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 
_ EXTENT TYPE 

• RELATIVE (TO ZERO! START 
NUMBER OF TRACKS 

_ SYMBOLIC UNIT 

• VOLUME SERIAL NUMBER 


ADDRESS 


IN TRACKS 


00 

I (PRIME DATA) 

0006 

387* 

SYS005 CCB FORMAT 0105 

TESTVl 






• HORKAR 

FILE IDENTIFIER 
_ FILE SERIAL NUMBER 

• VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 

• FILE TYPE 










WORK FILE FOR SLIB 

TESTVl 

01 

OMITTED 

69/001 

DIRECT ACCESS 






_ EXTENT INFORMATION 

V EXTENT SEQUENCE NUMBER 

EXTENT TYPE 
^ RELATIVE (TO ZEROI START 
• NUMBER OF TRACKS 

SYMBOLIC UNIT 
— VOLUME SERIAL NUMBER 


ADDRESS 


IN TRACKS 


00 

1 (PRIME DATA) 

3880 

0100 

SYSOIO CCB FORMAT OlOA 

TESTVl 






^ END OF LABEL CYLINDER DISPLAY 












(£xi3J8in-) 






■ 


■ 


■ 




HHHHIl 




An example of some of the output to a line printer after executing the LSERV program, part 2. 
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// DLBL filename, 'file ID', date, codes, data security 

// EXTENT symbolic unit, serial number, type, sequence number, relative track, number of tracks, split cylinder track, B bins 



// DLBL IJSYSRS,'DOS.RECORDER.FILE',99/365,SD 
// EXTENT SYSRES, 11111 1 .1 ,1 ,3960,20,, 



May also be printed as 
RETENTION PERIOD (DAYS) 
Depends on the manner used to 
specify date in the D LBL 
statement. 




n 



JOB CONTROL statements, 

for details see DOS/VS System Control Statements 



FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 



DOS LABEL CYLINDER DISPLAY 



mill 

01 

OMITTED 
99/365 
SEQUENTIAL 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE ITO ZERO I START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 

f CREATION DATE 

\ EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 
EXTENT TYPE 
EXTENT LOWER LIMIT 

EXTENT UPPER LIMIT 

SYMBOLIC UNIT 
VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE ITO ZEROI START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 




01 

1 (PRIME DATA! 

3880 

0060 

SYS004 CCB FORMAT 

mill 



DOS. RECORDER. FILE 

mill 

01 

OMITTED 

99/365 

SEQUENTIAL 



01 

1 I PRIME DATA) 



CYLINDER 

HEAD 

CYLINDER 

HEAD 

SYSREC 

mill 



198 

00 

198 

19 

CCB FORMAT 



NAME-LIST 

HELP«1 

01 

OMITTED 

69/001 

DIRECT ACCESS 



00 

1 (PRIME DATA) 

0020 

0003 

SYS005 CCB FORMAT 

HELPil 



_^xJf^AX. 



G 



Relationship between DLBL/EXTENT card data and the information printed by the LSERV program. 



2.110 Serviceability Aids. 



Under certain circumstances knowing the contents of libraries can be helpful 
during program debugging. The library display programs DSERV, CSERV, PSERV, 
SSERV, and RSERV enable you to print an image of: 

• Any library directory 

• Any library 

• Any program in any library 

• Any phase in any library. 

Wlien using DSERV, a System Status Report is always printed before the specified 
directory. A private status report is also printed when private libraries are used 
with the system. 

An example of a system status report is shown in two examples at the end of the 
section describing the Linkage Editor Map (E-4 of this manual). 



Library Display Programs and Utilities 

LIBRARY DISPLAY 



...y 



When and how to use 

Control statements required to execute the library display programs are shown in 
the next two tables. 

The following list gives some examples of when to use the various library display 
programs: 

1. The operator action given under the appropriate message in DOS /VS Messages 
indicate when to execute DSERV. 

For example, under the message: 
1C33A PROGRAM NOT FOUND 

When error message instructions include a library display, enter cards that 
correspond to the library and type of display. Be sure to substitute the actual 
program module, book, sublibrary or phase name for the words phase 1 , module 1 , 
book 1 , sub lib 1 , or prog 1 . 

Note: If you assign a private library and display that type of library, only the private 
library will be displayed. To obtain a display of the system library, the private 
library must be unassigned. 

Additional inforination on the display program is found in DOS/VS System 
Con tro I Sta temen ts. 

Further recommendations as to when to use the library display programs are given 
after the two tables following. 
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LIBRARY 
DISPLAY 



Control cards required to execute the Library display programs 



Unit 


Element 


Control Statements R eq u ired 


Core Image 
Library 


Phase 


// JOB jobname 
//EXECCSERV 

DSPLYphasel [,phase2,...] 

/• 
/& 


Program 


// JOB jobname 
//EXECCSERV 

DSPLY prog1.ALL[,prog2.ALL,...] 

/* 

/& 


Library 


// JOB jobname 
//EXECCSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLYCD 

/* 
/& 


Sorted 
// JOB jobname 
//EXECDSERV 

DSPLYS CD 

/* 
/& 


Relocatable 
Library 


Module 


// JOB jobname 
// EXEC RSERV 

DSPLY modulel [,module2....] 

/* 
/& 


Program 


// JOB jobname 
// EXEC RSERV 

DSPLYprog1.ALL[,prog2.ALL,...] 

/* 
/& 


Library 


// JOB jobname 
// EXEC RSERV 
DSPLY ALL 

/* 

/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLY RD 
/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 

DSPLYS RD 

/* 
/& 



Table C-2 Library Display Control Cards (Part 1 or 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, or a disk drive. 
SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or for the Model 125 
it must be assigned to the CRT. 
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Unit 


Element 


Control Statements Required 


Source 

Statement 

Library 


Book 


// JOB jobname 
// EXECSSERV 

DSPLY sublib.bookl [,sublib.book2,...] 

/* 
/& 


Sub- 
library 


// JOB jobname 
// EXECSSERV 

DSPLY sublibi .ALL[,sublib2.ALL,...] 

/* 
/& 


Library 


// JOB jobname 
// EXECSSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXECDSERV 
DSPLY SD 

/* 


Sorted 
//JOB name 
//EXECDSERV 
DSPLYSSD 

/* 
/& 


Procedure Library 


Directory 


Unsorted 
// JOB name 
// EXEC DSERV 
DSPLY PD 

/* 
/& 


Sorted 
//JOB name 

// EXEC DSERV 

DSPLYSPD 

/* 
/& 


Library 


//JOB jobname 
//EXECPSERV 
DSPLY ALL 

/* 
/& 


Procedure 


//JOB jobname 
//EXECPSERV 

DSPLY procedurel [,procedure2,..] 


Directories 


All 


Sorted 
//JOB name 
// EXEC DSERV 
DSPLY ALL 

/* 
/& 


Sorted 
// JOB jobname 
// EXEC DSERV 
DSPLYS ALL 

/* 
/& 


Systems 
Directory 




// JOB jobname 
// EXEC DSERV 

DSPLY SD 
/* 
/& 




Table C-2 Library Display Control Cards (Part 2 of 2) 
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LI B R AR Y D ISP LAY 2. Execute DSERV when you require details about the core image library. 



p 


•SYSTEM CORE IMAGE DIRECT 


^ 


■ 






^ 


^^ 






/73 PAGE 10 






















H * 


' PHASE 


DISK 




TXT 


BTS LST 


RLD 


RLD 


LOAD 


ENTRY 


PART ENTRY 


SVA 


IN 






1 4 


NAME 


ADDR 




RCDS 


TXT RCD 


RCDS 


ITEMS 


ADDR 


ADDR 


ADOR ADDR 


ELIG 


SDL 






1 




C 


H 


R 
























^H * 


' 66RAST13 


005 


00 


02 


001 


0582 






000000 


000000 












^H 


elJKSOO 


033 


06 


04 


001 


0536 






000000 


000000 












^H ^ 


1 €IJKS10 


033 


06 


05 


001 


0234 






000000 


000000 












^H 


EIJKS20 


033 


06 


06 


001 


0488 






000000 


000000 












^H 


eiJKSBO 


033 


07 


01 


001 


0592 






000000 


000000 












^H ^ 


1 EIJKS40 


033 


07 


02 


001 


0392 






0000 00 


000000 












^H 


6IJKS50 


033 


07 


03 


001 


0360 






000000 


000000 












^H 


EIJKS60 


033 


07 


04 


001 


0572 






000000 


000000 












^H g 


1 SIJKS70 


033 


07 


05 


001 


0584 






000000 


000000 












^H 


6IPLRT2 


005 


02 


06 


006 


0072 






000000 


000C68 












^H 


£IPLRT3 


005 


03 


06 


003 


0248 






O0OC68 


000C68 












^H 1 


1 £IPLRT4 


005 


04 


03 


006 


0416 






000C68 


0O0C68 












^H 


6IPLRT5 


005 


05 


03 


005 


0240 






000C68 


000C68 












^H 


KJOBACCT 


005 


09 


03 


001 


0002 






000000 


000000 












^H 1 


1 6J0BCTLA 


000 


17 


03 


O09 


0720 






000000 


001810 












^H 


6J0BCTLB 


000 


18 


06 


004 


0340 






001810 


001810 












^H 


tJOBCTLO 


000 


19 


04 


on 


05 04 






001810 


001810 












^H < 


1 SJOBCTLE 


001 


01 


03 


007 


0610 






001810 


001810 












^H 


SJOBCTLF 


001 


02 


04 


006 


0444 






001810 


001810 












^H 


SJOBCTLG 


001 


03 


04 


006 


0148 






001810 


001810 












^H < 


1 ejOBCTLJ 


001 


04 


04 


008 


0208 






001810 


001810 












^H 


6J0BCTLK 


001 


05 


06 


005 


0972 






001810 


001810 












^H 


SJOBCTLM 


001 


06 


05 


007 


0135 






000000 


000000 












^H 1 


K EJQBCTLN 


001 


07 


06 


OOl 


0784 






001810 


OOlSiO 












^H 


ELIBSTAT 


005 


02 


01 


004 


0984 


001 


00011 


040800 


040800 


040078 


YES 








^■o 


ELNKEDT 


005 


06 


02 


019 


0491 






000000 


003EC8 












^Ho^ 


1 SMAINDIR 


005 


00 


03 


010 


0976 


000 


00011 


040800 


040800 


040078 


YES 








^H 


ALIST 


010 


12 


05 


012 


05 2 8 


001 


00100 


040078 


040300 


040078 










^^ 


^^^^^A^D^^^ 


0^ 


08 
■ 


03 
■I 


004 


0700 


000 


00053 


040078 


0403^, 


040^^^^^^ 






^^^^^^^^^Sfff 




^^1 




H 


■ 


■ 


H 


HHH 


Hill 






IHIH 


I^HHHH 






HBHMHHM 





PHASE NAME 


The names of programs (phases) 


DISK ADDR 


The disk address of the phase on the core image library (Disk address of first text, TXT, record) 


TST RCDS 


The number of records belonging to the phase (Number of TXT records) 


BTS LST 
TXT RCD 


The number of TXT bytes in the last TXT record 


RLD RCDS 
(see note 1 ) 


The number of additional relocation list dictionary (RLD) records, referring to the address constants in the text 
that will be modified by the relocating loader 


RLD ITEMS 
(see note 1 ) 


Total number of RLD items that show the total number of TXT modifications due to relocating load 


VER MOD 
LEV LEV 
(see note 2) 


The version and modification level of phases, modules, and books in the core image, relocatable, and source 
statement libraries respectively. 


LOAD ADDR 


The load address of the phase at the time it is link-edited to core image library (Link-edit time) 


ENTRY ADDR 


Entry address of the phase at link-edit time 


PART ADDR 
(see note 1 ) 


Start address at link-edit time of the partition to which the phase is link-edited 


ENTRY ADDR 


The entry address in the SVA of the phase contained in the SVA. (These phases can be loaded into the SVA after 
IPL or by cataloging them into the SVA during system operation.) 


SVA ELIG 


A YES in this column indicates that it is permissible to load the phase in the SVA either after IPL time or during 
system operation using the linkage editor. 

(It indicates that the phase is reentreable and relocatable which it must be to enable its use by the system when it 
resides in the SVA.) 


IN SDL 


A YES in this column indicates that the name of the phase is in the SDL. 

Note: A phase name can be present in the SDL but need not necessarily be present in the system core image 

library. 



V, 

J 



Notes 1. Entries are printed in ttiese columns only when a relocatable phase is found in the library. 

2. Version and modification levels are always listed for modules and books displayed, but are listed for phases 
only when displaying a specific phase. This information is required under some conditions of system mal- 
functions that may be caused by the use of programs at different levels of modification. 

Most IBM-supplied programs have a 2-byte VM (version and modification level) number. The number may be 
in decimal or hexadecimal form in a storage dump, depending on the input format. It is in decimal form in a 
DSERV printout of the source statement or relocatable library. For example, version 5 modification level 
appears at 2800 or F2F8 in a storage dump and a 5.0 in a DSER V printout. The VMs for phases and transients 
are contained within the phase or transient. 

Your IBM CE/FE can also check your library by using DSERV to examine it for the applicability of an IBM- 
supplied program temporary fix (PTF). 

The modification level of your library is also required if an authorized program analysis report (APA R) must 
be submitted to IBM for analysis of a particularly difficult programming error. 
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TES or TES with Operands E R E P 

The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history /RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing, 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES,NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape errar data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format, 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PRINT.SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES.SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printed on SYSLST in the detail volume 

serial number format, SYS008 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
I Appendix J. 
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EREP EREP History Tapes 



There are three types of EREP history tapes: the History tape, the RDE tape, and \._/' 

the TES history tape. The History and RDE tapes are created and updated from the 

SYSREC file and contain all the record types found on the SYSREC file. The TES 

history tape is also created from the SYSREC file, but contains only tape error 

records. If your installation has the History/RDE tapes and a TES history tape, you 

should create (or update) all the history tapes in the same run. If this procedure is 

not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 

History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is linJc-edited as a self-re locating program, a LBL TYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 

Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape' reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E1 6A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 



\J 
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Updating will continife with the next update control card for all errors except when: 

• The COL statement has invalid operands. 

• COL statement is not the first update control statement. 

• The macro is completely de-edited without all update control statements 
being completely processed. 

• An RST statement has an invalid operand. 

Appendix D shows two ESERVjob stream examples. 



ESERV 




macro source 
deck 




SYSIPT 



SYSPCH 




ESERV 







SYS001/2 

This illustrates the input to and output from the ESERV 



SYSLST 



When to use 



• Use ESERV to punch up a new card deck. 

• ESERV can be used to list the source code of an edited macro. 

• If an IBM program tempory fix (PTF) is to be installed in your library, use 
ESERV to de-edit and update the macro. An example of instaUing a PTF 
using ESERV is given in appendix D. 

Note: Before installing a PTF use either ESER V or SSER V to display the macro in 
order to check if the PTF is applicable. 
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LVTOC 



The LVTOC program enables you to print out VTOC (volume table of contents) of 
a DASD disc pack. 

From the printout (the VTOC display), you can see the names of files, contained 
on any disc pack, their extents, and addresses. A VTOC display, therefore, enables 
you to keep track of data sets and files on all your packs. 

Additional information on the VTOC display program can be obtained from 
DOS I VS System Control Statements 



Information in the VTOC 

All standard file labels are grouped together and stored in a specific area on a disk 
pack or data cell. This group of labels essentially a directory of all data records on 
the volume because each file label contains file limits. Therefore, this group of 
labels is called the volume table of contents, or VTOC. Because the VTOC itself 
is a file of records containing one or more standard label records for each logical 
file, it is defined as such with its own file lable. 



Last 

Volume 

Label 



VTOC 
File Label 
(Format 4) 



VTOC 
File Label 
(Format 5) 
(Used by 
OS/VS 
only) 



File 
Labels 



Filename = 

xxxxxx 

Format 1 
Label 



Additional 
File Labels 



Filename = 
XXXXXX 
Additional 
Extents 
(Format 3) 



Pointer to 
last active 
file label 



Pointer to 
additional 
file extents, 
if necessary. 



Function of the VTOC 

Before a DASD file can be processed by logical IOCS, the file must be opened to 
permit transfer of data. The open routines check the DASD labels identifying the 
file. This is accomplished by comparing the information from the actual file 
labels in the VTOC with the label information in the SYSRES label information 
cylinder. (See LSERV in this Section for a description of the label cylinder.) 

The illustration opposite is a overview of how DOS/VS uses the VTOC. 






DASD Label Formats 

The VTOC contains all format labels. Each format label points to an area of DASD 
storage on the volume and indicates what the area is currently being used for. A 
format I label describes one to three physical areas (extents) on the volume. It is 
the first format label used to describe each file. 

A format 2 label describes a file as being indexed sequential. If a format 2 label is 
used, there is always a format 1 label describing the same file. 

A format 3 label describes from one to thirteen extents on the volume. It is used 
when a file is made up of four to sixteen extents (the format 3 label is always 
associated with a format 1 label). 

A format 4 label describes the VTOC. 

A format 5 label is not used by DOS/VS. 

The following illustrations show the layout of format labels 1 to 4, with examples 
of printouts from the VTOC display program. 

A detailed description of these label formats is given in DOS I VS Data Management 
Guide. 






2.118 Serviceability Aids. 






Prog 




Library Display Programs and Utilities 

LVTOC 



Filename for DTF matches 
filename in DLBL statement 



Job //DLBL Filename, File ID , etc. 

control // EXTENT Symbolic name. Volume number 



o 



Standard Volume Label: 
Cylinder 0, Track 0, Record 3 
(Written during disk 
initialization) 



The VTOG 
Format 4 label 




Label information 
cylinder 




SYSRES 



During the OPEN routine: 

1. Read SYSRES label information. 

2. Locate the VTOC via the 
standard volume label. 
For DASD input files: 
Compare format 1 label information 
(or format 2 for IS files) to information 
in the DLBL card. 
Check each extent definition in 
format 1 and 3 labels against the 
limit fields in the EXTENT card(s). 
For DASD output files: 
Create the format 1 label from 
information in the DLBL/EXTENT 
cards. (Format 1 is always present 
followed by format 2 for IS files) . 
If extra extents are to be desaibed 
create format 3 labels following 
the format 1 or 2, or another format 3. 

During the CLOSE routine: 
1 . Read, update, and rewrite format 1 
and 2 labels for IS files. 



An overview showing how the DOS/VS uses the VTOC. (Not applicable to VSAM 
files) Details are found in DOS LIOCS Vol 1 
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LVTOC Executing the VTOC display program 



The control cards necessary to execute VTOC in a virtual partition are: 

// JOBjobname 

// ASSGN SYS004,X'cuu' (input) 
// ASSGN SYS005,X'cuu' (output) 
// EXEC LVTOC 

/& 

The operator commands necessary are: 

1. Press REQUEST on the console printer keyboard 

2. PAUSE (BG F4, F3, F2, Fl), EOJ 

3. // ASSGN SYS004,X'cuu' (input device) 

4. // ASSGN SYS005,X'cuu' (output device) 

5. // EXEC LVTOC 

Where: 

• SYS004 is assigned to the channel and unit address (cuu) of the DASD on 
u'hich the disk pack is mounted. 

• SYS005 is the output device, normally a printer. If the output device is not 

a printer, TLBL, DLBL, and EXTENT cards must be included to describe the 
output device. The filename for these cards is UOUT. 

The first of the two examples on the opposite page is a VTOC display using the 
LVTOC program. 

Two other methods of obtaining a VTOC display are as follows: 

• Instead of typing CANCEL to terminate the job, the operator can type 
CANCELV to get a VTOC dump on SYSLST, if SYSLST is a printer. Refer 
to the second example on the opposite page. 

• The operator can display the VTOC by typing DSPLYV (in response to an 
error message). This reply does not terminate the job, but reissues the same 
message issued prior to the VTOC display request. (The output can be 
directed to SYSLOG if SYSLST is not assigned.) Refer to the example at the 
end of this chapter. 

Operator actions given in DOS /VS Messages indicate methods to obtain a VTOC 
display for particular messages. 



When to use 

The five examples listed below illustrate when and how the VTOC display program 
can aid program debugging by providing details about your disk volumes: 

1. During disk pack initialization, the VTOC label is checked. A message is printed 
on SYSLOG if there is an unexpired file in the pack. If the contents of the pack 
are unknown or its vaHdity is in doubt, a VTOC listing will enable you to check 
the unexpired file. You can then decide if the unexpired file is to be retained 

or replaced by different extents. 

2. Before copying a volume it is useful to keep a record of the contents of the 
volume to be copied and the volume that receives the copy. Having a record will 
reduce debugging time if an error occurs in a program that uses one or both of 
these packs. 

3. A VTOC display enables you to monitor and keep track of volume areas, thus 
allowing economical use of your packs. 

4. If the input data contained on a pack is causing program errors, a VTOC listing 
of the input volumes enables you to check for the presence (or absence) of data 
sets. 

5. If, during program execution, a system malfunction prevents workfiles from 
being properly closed by the CLOSE macro, it is probably that volumes used 



\^J^ 



y 
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during the program will cause program errors when used for future jobs. This is 
because the VTOC label would not have been updated by the CLOSE macro. It is 
useful, therefore, to obtain a VTOC listing of the volumes affected. 



Examples of the LVTOC output 



LVTOC 



f 


^■'™' 




VTOC DISPLAY UTILITY 


^ 




I * 


' LABEL IDENT - 


VOLl 


VTOC LOCATION IS CYLINDER - 199 


SERIAL NUMBER - 111111 OMNER 


IDENT - ^1 


1' 


' T 0,R 1 FCRMAT « 


LAST ACTIVE UNUSED ALTERNATE TRACK INFORMATION 
FORMAT 1 LABELS LOCATION NO. OF TRACKS 


EXTENT INFORMATION ^| 
SEQ TYPE LQH HIGH ^H 


1 * 






473 200 




60 


PRIME 199 199 18 ^| 


1 * 


7 O.R 2 FCRMAT 5 


USED 


ONLY BY 0/S 360, NOT SUPPORTED BY DOS 










■ ' 


' T O.R 3 FORMAT 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCD 


DATES 
CREATE EXPIRE 


SYSTEM 

I DENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 


1 * 


' PAGE DATA SET 




2048 


2048 


73 278 99 365 


IBMDOSVS 


180 186 19 


1' 


' T O.R 4 FORMAT 1 




SERIAL NUMBER - 111111 LENGTHS 
FILE ID KEY BLOCK 


RCD 


DATES 
CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 


I * 


DOS. RECORDER. FILE 










73 278 99 365 


IBMDOSVS 


1 PRIME 198 198 19 


^K 


T O.R 5 FORMAT 1 




SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 


RCD 



DATES 
CREATE EXPIRE 

73 278 73 249 

DATES 
CREATE EXPIRE 

73 278 99 365 


SYSTEM 
IDENT 

IBMDOSVS 

SYSTEM 

IDENT 

IBMDOSVS 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME^21 14 41 13.^ 

EXTENT INFORMATION 
SEQ TYPE LOW HIGH 

1 PRIME 1 20 19 


' 1 BUG. GENERATOR. KORKFILE.K 
T O.R 8 FORMAT 1 
DOS.WORKFILE.NO.O 
END OF VTOC LISTING 


TOMS ^/^ ^cie^tj/^ 


SERIAL NUMBER - 111111 
FILE ID 


LENGTHS 
KEY BLOCK 




RCD 



^^. 


i,^A.<.aM. 


^ 1 


^Hl 






^HH^^Hl^^HI 


^^^Hl 


1^1 


HiJ^HHH 


Hl^^l 






An example of the output on a line printer after executing the LVTOC program 



\^ 




An example of the output on a line printer after issuing the CANCELV command 
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LVTOC 



iBG ASSGN SYSPCHrX'J,31' 

;BG 4444A OUflRLAP ON UNEXF'RD FILE 

I BUG » GENEFiATOR r WGRKF 1 LE „ K , TOMS 

! BG di>p I YV ^ 

;BG 4V95A SYSLGG OR SYSLST 

I B(j <; Y <; I 9 ^k^ .^ 

:bg 



I .JS YGPH 8 YSF'CH== 1 3 1 1 1 1 1 1. 1. 



PSPLyV .C<?'yy^yytva^ 



BG VOLUME SERIAL ND„ IS :l. :l. 1 1 1 1 



BG PAGE DATA SET 
IBG 2:1.00 OOB40000-OOBAOOI3 



BG DOS „ RECORDER n FILE 
!bG 0101 OOC60000-OOC60013 

\ BG (ibug . g i;::nerator >j»jorkf i le^ k . tghs » 

! BG vO 1 1,^)0 1 '5000E J-i()029000D'' 



10/04/13 
1111111 0001 0D01i::5--63016D 

1111111 0001 0D0115-63016D 




cy HO cy H6 

.WORKFILE,.NO„0 
1 00010000-00140013 



•IS I 1111111 (OOOn 0D0115-4yOOI-\ 

^ 1111111 0001 0D0115-63016I 



l4t!^<W6 



iBG UTGC DISPLAY COMPLETED 



A 



An example of the output on a 3215 console printer keyboard after issuing the 
DSPLYV command. 



^HZ^KT 



1 


VOLUME SERIAL NO. IS llllll 




12/06/73 


a< 


^ DOS. RECORDER. FILE 

0101 OOC60000-OOC60013 




lllllll 


0001 490154-63016D 




DOS RECORDER FILE 
^ 0101 OOC40000-OOC40013 

^ PAGE DATA SET ^^'^^ 




1111111 
lllllll 


0001 490034-63016D 
0001 490154-63016D. 


' 2100 ,00840000,-00880013' 


^ VTOC DISPLAY COMPLETED 



c 



An example of the output on a line printer after issuing the DSPLYV command. 
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Intentionally Blank 



o 
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Library Display Programs and Utilities 

The S YSVIS DUMP program copies the contents of the page data set (PDS) S YS V I S D U M P 

contained on the system logical unit SYSVIS on to magnetic tape or disk pack. 
A printout on SYSLST can then be obtained for use during offline program 
debugging. The utiUty also enables you to dump the contents of the PDS directly 
to SYSLST, which can be assigned to a tape unit,, a disk drive, or a line printer. 

The SYSVIS dump may also be referred to as the Page Data set dump. 

Restrictions 

This utility program can be used only to copy or dump the contents of the PDS 
contained on SYSVIS. Any other use is automatically rejected by the system. 
Because paging must not occur during execution of this utility when dumping 
from SYSVIS do not start or run any other jobs either before or during its execution. 

Description and operation 

This utility program is initiated by normal JCL through SYSLOG or SYSIPT by 
the execute statement // EXEC PDSDM. Parameters entered either through 
SYSLOG or SYSIPT enable you to select areas of SYSVIS, thus avoiding the 
need to dump all of the virtual address area contained on SYSVIS. 

The following areas can be selected: 

• The entire PDS, that is, all the virtual address area 

• Arty specified virtual partition 

• One or more pages contained within any virtual partition. 

Multiple parameters can be specified but they must be confined to one card 
image. Multiple cards are possible. 

For example: 

BG, (089ABC,08ABCD), F4 punched in a card or entered through SYSLOG 
causes a dump of the whole of the background and foreground 4 virtual 
partitions, and the pages on the PDS that contain any addresses between the 
address limits 089ABC and 08ABCD. 

(Addresses are specified by six hexadecimal digits.) 

The dump output is directed to SYSLST or SYSOOl , depending on the parameters 
specified. For example, a response to SYSLST to the message 0V23D T0= causes 
the dump to be directed to the device assigned as SYSLST. 

If SYSOOl is used as the input or output device, tape or disk label information 
must be supplied in the job stream. 

If the dump is from SYSVIS, it is accessed by assigning SYSOOO to it. The 
necessary disk label information must then also be supplied in the job stream. 

Job stream examples are shown on the following pages. 

The format of the dump output is similar to the output obtained from the 
stand-alone dump, that is, each 2K of virtual storage contained on the PDS is 
separated and given a block number starting with BLOCK 0000. Blocks 
containing only zeros are suppressed. An example of the stand-alone dump 
output is shown in Appendix G. 
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Library Display Programs and Utilities 

S YS V I S D U M P How to execute 



Because this utility consists effectively of three separate utility programs, it is 
necessary to show three sample job streams. 

Example 1 shows the job stream required to copy SYSVIS to SYSOOl, where 
SYSOOl can be assigned to either a tape unit or a disk drive. 

Example 2 shows the job stream required to dump SYSOOl to the device assigned 
toSYSLST. 

Example 3 shows the job stream required dump SYSVIS directly to the device 
assigned to SYSLST. 

To ensure that the contents of the PDS and the allocations of the virtual address 
area are the same as they were just prior to the execution of the stand-alone dump 
the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 

Example 1: Copying SYSVIS to SYSOOl on tape or disk, 
(SYSOOl must be a DASD device) 

// JOB COPYPDS where CUU is the physical address 

// ASSGN SYSOOO,X'cuu' of SYSVIS. 

// ASSGN SYSOOl ,X'cuu' where CUU is the physical address 

of the device to be used as 
temporary storage for the PDS. 

// DLBL PDSDISK/PAGE DATA SET 

// EXTENT SYSOOO 

// DLBL SOI DISK/BACKUP FOR PDS' [,date] 

// EXTENT SYS001,vol ID, ,relative starting address, number of tracks 



o 






If the PDS copy is to be on tape, replace the previous two statements by the 
following: 

// TLBL SOI TAPE,' BACKUP FOR PDS' 

followed by: 

// EXEC PDSDM where PDSDM is the phase name 

for the utiUty contained on the 
system core image library. 
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Example 2: Dumping SYSOOl to SYSLST 

// JOB DUMPPDS 
//ASSGN SYSOOl, X'cuu' 

// DLBL PDSDISK/BACKUP FOR PDS' 
//EXTENT SYSOOl 



Library Display Programs and Utilities 

SYSVISDUMP 



where CUU is the physical 
address of the device containing 
the copied PDS. 



If the copied PDS is on tape, replace the previous two statements by the following: 

// TLBL PDSTAPE/BACKUP FOR PDS' 
followed by: 

// EXEC PDSDM 

If parameters are to be read through SYSIPT respond to message 0V20D with 
IPT, press the END key and use the following statement: 

TO=SYSLST, T followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with LOG and press END if parameters are to be 
read through SYSLOG. 

Only pressing the END key as the answer to message 0V20D causes a dump of the 
whole PDS to SYSLST. 

If LOG is entered followed by END key the following message is issued on 
SYSLOG: 

0V23D T0= 

Respond to this with: 

SYSLST ,T This selects SYSOOl as input device and SYSLST as output 
device for the dump. 

This is followed by the message: 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
areas specified followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered but if no more areas of the PDS are to be 
dumped, either enter EOJ or press the END key. This terminates the job. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Library Display Programs and Utilities 

SYSVISDUMP 



Example 3: Dumping SYSVIS direct to SYSLST. 

//JOBDUMPPDS 

// ASSGN SYSOOO,X'cuu' where CUU is the physical address of 

SYSVIS. 
// DLBL PDSDISK/PAGE DATA SET 
// EXTENT SYSOOO 
// EXEC PDSDM 

If parameters are to be read through SYSIPT this must be followed by: 

TO=SYSLST followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with either LOG or IPX and press the END key. 
(END key only is an invalid response.) If LOG is entered followed by END key 
the following message is printed on S YSLOG : 

0V23D T0= 

Respond to this with SYSLST. This selects SYSVIS as input device and SYSLST 

as output device for the dump. 

This is followed by the message; 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
specified areas of SYSVIS and is followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered, but if no more areas of SYSVIS are to be 
dumped either enter EOJ or press the END key to terminate the job. 

Pressing the END key before entering parameters causes the whole PDS to be 
dumped on SYSLST. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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2.128 Serviceability Aids. 



o 



Library Display Programs and Utilities 

Error messages SYS VIS DUMP 

The list below summarizes the error messages that are printed on SYSLOG to 
inform the operator of incorrect job stream input: 

• Invalid parameters are specified. 

• SYSLST or SYSOOl is incorrectly specified. 

• Start address is greater than end address. 

• Partition is not allocated. 

• Address or partition is in real storage. 

• Address is greater than end of virtual storage. 

• Partition ID is invahd or greater than number of partitions allocated. 

• Incorrect assignments for SYSOOO and/or SYSOOl . 

• Attempt to dump a file other than the PDS. 

Incorrect addresses and partition IDs are flagged by an asterisk* printed on the 
line below. For example: 

BGbg,0809ab,f4,148000,05f5ee,(0809ab,096000)f2, 

BG * 

BG 0V40I ADDRESS IS OUTSIDE OF VIRTUAL PARTITIONS 

Pressing the END key causes the areas that are specified correctly to be dumped 
up to the first invalid parameter. The incorrect parameters can be corrected 
through SYSLOG. If the input is through SYSLOG, further parameters can be 
specified after the message: 

0V21D GIVE PARAMETERS 

If the input is through SYSIPT, you can switch back to SYSIPT as input device 
for specification of further parameters by entering IPT to the message: 

0V21D GIVE PARAMETERS 

Terminating the dump 

This can be done in any of the three ways given below: 

• Enter EOJ on SYSLOG 

• Having a /* or a /& card at the end of the job stream when entering 
parameters through SYSIPT. 

• Pressing the END key in response to the message: 0V21D GIVE 
PARAMETERS after at least one address has been processed. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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Library Display Programs and Utilities 



SYSVISDUMP 



When to execute the dump 



It is recommended to obtain a dump of SYSVIS whenever a stand-alone dump is 
executed. SYSVIS DUMP should not be executed until the stand-alone dump has 
been completed, and should be initiated during the system re-IPL. To help your 
analysis of the information contained in the SYSVIS dump it is also recommended 
to execute a formatted stand-alone dump as described in A-3 of this Section. For 
this reason, execution of this utility is included in the flowchart A-3-F "Executing 
the Stand Alone Dump". 



How to use the dump output 



During analysis of a system malfunction, such as a HARD WAIT STATE using a 
stand-alone dump output, it may be necessary to analyze the coding in a page 
belonging to a virtual partition which was not in real storage when the stand-alone 
dump was executed. 

The virtual address allocations can be obtained from the BOUNDARY BOX, and 
pages not in real storage can be found by analyzing the contents of the PAGE 
TABLE. The format and contents of the boundary box and the page table are 
described in Section 4, Chapter 12 of this manual. 

Therefore, the SYSVIS dump should be used in conjunction with the stand-alone 
dump output. It is recommended to always use a stand-alone dump generated with 
the DUMPGEN parameter FORMAT=YES. DUMPGEN is described in A-3 of 
this Section. 

It is essential that the operator save the copy of the PDS after executing the 
stand-alone dump. You as the system programmer, or the IBM CE/SE will then be 
able to print out all or any part of the PDS to complete problem analysis. 



^ 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
FEATURE (ALL MODELS) 



The ALTER/DISPLAY facility allows the operator to dump or display, and 

change the contents of various parts of the CPU storage (depending on the CPU 

Model) and of real or virtual storage. 

For the purpose of hands-on debugging, the following areas may need to 

be displayed: 

Any selected area of virtual storage 

General registers 

Floating-point registers 

Current PSW 

Control registers 



When to use 

ALTER/DISPLAY is useful for hands-on debugging, and enables the operator to 
obtain information about the system at the time a malfunction occurs. It must 
be used whenever a display of the low address storage is required, for example, 
to record a wait state message (see E-3 in this section). 

Flowcharts in section 3 indicate when to use this facility, and which option to 
choose for a particular system malfunction 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 
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How to use this feature 



Aids provided by the Operator's Console 



ALTER/DISPLAY 

MODELS 135 

AND 145 



INTVN 
REQD 



NOT 
READY 



CANCEL 



ALT/DISP 
MODE 



ALTER/ 
DISPLAY 




LOCK 



QEQQQQ0QQQQ 
QQQQQQQQDmB 



RETURN 



f ~ 




Spacebar 



] 



► 



Indicator 


Condition 


INTVN 
REQD 


The console printer is out of forms or the 
PR-KB is not ready. 


ALT/DISP 
MODE 


A request for an alter/display operation was 
accepted. 


ALARM 


An alarm command was issued, and manual 
intervention is required by the operator. 


PROCEED 


The PR-KB is unlocked and ready to accept 
characters. This indicator is turned on by the 
ALTER/DISPLAY key or by a read command. 


REQUEST 
PENDING 


A request operation was initiated. The indicator 
is turned off when the attention status is 
accepted by the CPU. 



Indicator 



► 
► 



Key 


Function 


NOT READY 


Places the console printer in a not-ready condition. 


CANCEL 


Used to terminate a read command when the operator has 
made an error in data entry. Normally, the program will 
issue the same read command again. 


READY 


Places the PR-KB in the ready state when forms are in the 
printer and the cover is closed. 


ALTER/ 
DISPLAY 


Requests or ends an alter/display operation. When used to 
end an alter/display operation, the PR-KB remains in alter 
/display mode. 


END 


Terminates a read, write, or alter /display operation. 


ALARM 
RESET 


Resets the ALARM indicator. 


REQUEST 


Initiates the attention routine to enable operator/ 
system communication 



Key 



o 



Indicators and Control Keys (3210 and 3215 printer keyboard) 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 135 145 
AND 115-11 

















u 


Table D- 1 below summarizes the ALTER/DISPLAY options, that can be selected 
when using the flowchart shown in D - 1 -F. 




Mnemonic 


Storage 
Area 


Address Range 




Alter 


Display 




AM 




DM 




Real address area 


000000-03BFFF* 




AV 




DV 




Virtual address area 


000000-1 6 megabytes 




t 




DS 




Control storage 


0000-DFFE*+ 




AG 




DG 




General register 


0-F 




AF 




DF 




Floating-point register 


0,2,4,6 




AP 




DP 




PSW 


None 




AC 




DC 




Control register 


0-F 




AK 




DK 




Storage key 


000000-03BFFF* 




AX 




DX 




Transmission speedtt 


1—8 (line number) 





Use address length shown; if necessary, fill-up with leading zeros. 

* Model-dependent. 

t You cannot alter control storage data. 

+ Control storage addresses are not continuous. For control storage address to be 
valid, leftmost (fourth-highest) digit must be: 

1 . For 24K control storage size; 0—5 

2. For 36K control storage size, 0—5, 8, A, or D(hex) 

3. For 48K control storage size, 0—5 or 8— D(hex). 

tt Line speed can only be changed if, with your ICA feature, you have the SDA 
II subfeature with clocking provided by the Model 135. = 600 bits per second, 
1 = 1200 bits per second. 



Table D-1. Options for the ALTER/DISPLAY feature. 






Notes: When the operation is ended with the ALTER /DISPLA Y key, the keyboard 
remains in ALTER /DISPLAY mode (ALT/DISP MODE indicator on). When the 
operation is terminated with the END key, ALTER/DISPLA Y mode is terminated. 

For ALTER/DISPLA Y of general and floating-point registers, a wraparound is 
performed (F to for general registers, and 6 to for floating-point registers). 
When addressing virtual storage, either a word or byte address may be used. If the 
starting address is not on a word boundary, the console printer spaces and aligns at 
the byte addressed. 
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Aids provided by the Operator's Console 



^fc^/ 



Yes 



Start 



Press STOP and wait until 
IVIAN indicator turns on 



Press ALTER/DISPLAY 
(printer-keyboard) and wait 
until PROCEED Light 
(printer-keyboard) turns on 



Type two-character 
mnemonic and hex address 



Specifies: 

1. Alter or display 

2. Storage area 

3. Address in virtual 
storage 

See table D-1 

for choice of options. 




No 



Type hex data to alter 
information as required. 
(See "Format of Printout. 




Display — printer-keyboard 
print required data. (See 
"Format of Printout." 



Press END 
(printer-keyboard) 



ALTER/DISPLAY 

MODELS 135, 145, 

AND 155-11 



D-l-F 



Carriage return and line feed occurs. 
ALT/DISP MODE indicator turns on. 



Data may be entered, one digit at a 
time, using the space bar to skip over 
positions not being altered. The data 
in the skipped-over positions remains 
unchanged and is printed out each 
time the space bar is operated. To 
end the operation, press the END or 
the ALTER/DISPLAY key. 



Data is printed starting at the address 
specified and continued until the 
END or the ALTER/DISPLAY key is 
pressed. (Contents of locations or 
registers are not affected.) 



Line feed occurs; ALT/DISP MODE 
indicator turns off; system is in the 
manual state. 



To resume processing 
press START 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 135, 145, 
AND 155-11 



Format of printout 

Starting at the specified address, the display is printed in groups of eight characters 
with up to eight groups per Une. Depending on your starting address, the initial 
group might not contain eight characters. When general and floating-point registers 
are displayed, the address sequence 'wraps,' that is, the highest available address 
is followed by the lowest address (zero). 

When altering, enter new hex characters in the positions occupied by the characters 
to be replaced. Reach the required positions by repeating characters to be 
retained. 

Examples are shown below of the printout (reduced in size) from a 3215 console 
printer by using the ALTER/DISPLAY feature. 

Example 1 

This example shows a display of the 

• current PSW (DP) 

• general purpose registers (DG) 

• control registers and 

• low address storage. 



.1 U\' 



0741.10000 000B9ABC 

m: 

004000FF 0000E640 
O.QO.O.E.EFE OOOOOQOQ. 

.nn 

00089A7C 00089E80 

.0-0089.9.7.8 oo.oa9£aa. 



..riw....o.ooo.oo. 

00000000 
..U.7.4.DO.0.0O 

4000E6E0 
..u.4.0C.uftU.O 

00000540 
..OOOO.U.0.0.0 

00000000 
..O.uOO.uOO.O 

00000000 

..oo.o.oo.oo.o 

ooooooch)— 

..0.0.00.0.00.0 

00000000 



00000000 
.00.089.662.. 
OC 00 00 00 
..O0.0.O0.BCC.. 
00000000 

..oooooooo.. 

00000000 

oooooooo. 

00000000 
.000.00.000.. 
-OOO<)0000 
.0.0.000.000.. 
00000000 



FFFFFFFF 
.0.00.0.0.00.0.. 



000a9E78 
.0009E44.7. 



00000000 
..040.COOOO.. 
400070B8 

..o.oocoooo.. 

00020007 
..2.000.00.6.0.. 
00000000 
.00000000.. 
00000000 
.0.00.000.00.. 
00000000 

..oooooooo.. 

00000000 



FFFFFFFF 
00000000. 



00089EAC 
..400a9FfJ.A.. 



00000000 

OOOOOyM. 

00000000 

OOOOA-'illC.. 

00040000 
...0.000.0.2CO.. 

00000000 
.00.000000.. 

00000000 
.000.00000.. 

000 00 000 
.000.00000.. 

00000000 



00000000 

ooo.ooooo.. 



00089E80 
4008AD9A 



00000000 
.00000000. 
FAE40800 
04080000 
40091.1840 
OOOOOOOO. 
00000000 
..OOOOOOOO. 
OOOOOOOO 
OOOOOOOO. 
OOOOOOOO 
■OOOOOOOO. 
OOOOOOOO 



OOOOOOOO 
OOOOOOOO.. 



00000019 
0.0Oa92EO.. 



00004450 
OOOOOOOO.. 
020AFE51I 
.O0O0D13A 
00020000 
■OOOOO-IOO.. 
OOOOOOOO 
OOOOOOOO. 
OOOOOOOO 
.0.0000000 
OOOOOOOO 
..OOOOOOOO.. 
OOOOOOOO 



OOOOOOOO 
..C20OO0OO 



A0089EDC 
80.089EFO 



OOOOOOOO 

O7.0F20OO. 

040C0000 

O4.0C0OO0 

OOOOOOOO 

00000430; 

OOOOOOOO 

-OOOOOOOO. 
OOOOOOOO 
OOOOOOOO. 
OOOOOOOO 

..OOOOOOOO-. 



OOOOOOOO 
.00000200.. 



0008A157 
00089 AAO.. 



OOOOOOOO 
000.0090C 
00OOOC14 
OOOOOEIO 
OOOOOICC 
OOOOOOOO. 
OOOOOOOO 
-OOOOOOOO.. 
OOOOOOOO 
.;0OO0OC)X)O.. 
06000000 
..OOOOOOOO.. 
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Example 2 

In this example, the contents of control registers 9,10, and 1 1 were altered. First 
the operator displajTed the contents by using the DC option. Then using the AC 
option, he entered the new data. To ensure that the data change was successful, 
the operator has displayed the control registers again. 





m 






^■■" 




^■" 








■■■ 




W. 9 
: OI^123DOO 


OOOOOOOO 


90000000 


OOOOOOOO 


OOOOOOOO 


C2000000 


00000200 
OOOOOOOO 


004000FF 
OOOOEOOO 







• 


; O000E640 


FFFFFFFF' 


■Tfffffff 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 




■■; '^c 9 

; 0()OO00AA 


AA8<i>i6300 


BEF 12301 














1 W. 9 

T <ii00000AA 

! 0000E640 

" T 

1 
















A<ii8^&360 

FFFFFFFF 


DEFi2301 
FFFFFFFF:. 


OOOOOOOO 
OOOOOOOO 


OOOOOOOO 
OOOOOOOO 


C2000000 
OOOOOOOO 


00000200 
OOOOOOOO 


004000FF 
OOOOEOOO 










(£x4iZ/f7^ 




IH 






i^m 




■HUH 








■!■ 
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Error Messages 

An ALTER/DISPLAY operation is terminated when an ALTER/DISPLAY error 
message occurs or when the end of a storage area or register is reached. 



Aids provided by the Operator's Console 

ALTER/DISPLAY 

MODELS 135, 145, 

AND 155-11 



Model 135 Alter/Display Error 

Invahd character: An invalid character is created when you use the mnemonic not 
shown in the table, when you address a feature not installed on your system, or 
when you enter an address or data character that is not a hex digit. An invalid 
character is ignored (no print or space occurs). Continue by entering the correct 
character— it is not necessary to restart the whole operation. 




o 



Invalid address: An invalid address is created when your address is not addressable 
location (the address might be outside the storage capacity of your system or you 
may be trying to address a virtual address that is not in the real address area) or 
when you address an ICA line either not installed or not fitted with the SDA II 
sub feature with clocking by the Model 135. An invalid address terminates the 
operation with the message '?ADR.' You must start again. 

Invalid Data: When changing the transmission speed for a communications link 
(AX or DX mnemonics), the only valid data characters are '0' or '1 .' When any 
other hex character is entered, the operation is terminated with the message 
'?DATA.' The transmission speed remains unaltered. 

Invalid -Format PSW: When you enter an invalid -format PSW, the PSW is 
altered but an interruption is generated when the invalid PSW is subsequently 
used. 



Model 145 Alter/Display Error 

Invahd Character: INVAL CHAR is printed if one of the following occurs: 

• The first character of a mnemonic is not A, D, or T (see Keyboard Test 
Mode Operation). 

• The second character is not M, S, L, K, C, G, F, or P. S and L are reserved 
for service personnel. 

• An invalid digit is typed when addressing or altering data. 

• The CANCEL key is pressed. 



Invalid Address: INVAL ADDR is printed if one of the following errors occurs: 

• Invalid starting address. 

• The updated address exceeds the capacity of specified storage. 

• The operator performs an AS or AL operation. 

• You may be trying to address a virtual address that is not in the real 
address area. 



Model 115-11 

As a result of the editing function, the following indications are given: 

1. If an invalid character is detected in the op code, storage mnemonic, or hex digit 
(0-9 and A-F), the printer does not respond. The operator can then rekey the 
correct character. 

2. If an invahd address (beyond the physical storage) is detected the error message '?' 
is printed. 

3. If an alter PSW operation is invalid, the PSW is restored to its original value 
and '?' is printed. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY The ALTER/DISPLAY facility allows the operator to display or change the 

MODE LS 1 1 5 AND 1 25 contents of the following parts of the CPU (Central Processing Unit), and of real 

or virtual storage areas: 

• General registers 

• Floating-point registers \^ 

• Current PSW 

• Control registers 

• Protection keys 

• Real storage areas 

• Virtual storage areas. 

A "hard copy" of all information displayed on SYSLOG can be obtained on a 
Model 115 and 125 with a 5213 printer attached by pressing the COPY key after the 
information is displayed. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 



o 



\^^ 
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Aids provided by the Operator's Console 



How to use 



ALTER/DISPLAY 
MODELS 115 AND 125 



Before the ALTER/DISPLAY feature can be used, the mode select display shown 
below must be brought to the screen by pressing the MODE SELECT key. 



MODE SELECTION 



R SYSTEM RESET 
C ADDRESS COMPARE 
L PROGRAM LOAD 
INTERVAL TIMER 
K CHECK-CONTROL 
D STORAGE DUMP 
- ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 




To select the ALTER/DISPLAY feature: 

1. Type A into the mode select display. 

2. Press the ENTER key. 

The ALTER/DISPLAY picture as shown below is brought to the screen and 
shows those parts of the CPU and real/virtual address areas that can be altered 
and/or displayed. 






* ALTER/DISPLAY * 

G GENERAL REGISTERS 

C CONTROL REGISTERS 

P CURRENT PSW 

F FLOATING POINT REGISTERS STORAGE ADDRESS 

K PROTECTION KEY 000000 - FFFFFF 

M MAIN STORAGE REAL 000000 - FFFFFF 

V MAIN STORAGE VIRTUAL 000000 - FFFFFF 



MODE SPECIFICATION: 



To select a particular display: 

1. Type in the associated mnemonic according to the instruction given in the 
next flowchart. 

2. Press the ENTER key. 

Before ENTER is pressed, you can still change your input by using the cursor 
keys and entering the changes in the usual way. As soon as ENTER is pressed, 
the new data replaces the old. The display remains on the screen and the 
cursor is at the next ALTER/DISPLAY line. Because there is an A (for 
ALTER/DISPLAY on this Une, you need only enter F (for floating point 
registers) or P (for PSW), and so on. 



\J 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



G 

GENERAL 

REGISTERS 


To display: 

1 . Type G into the alter /display picture. 

2. Press ENTER. 

All general registers appear at once. 


F 

FLOATING- 
POINT 
REGISTERS 


To display: 

1 . Type F into the alter/display picture. 

2. Press ENTER. 

All floating-point registers appear at once. 


P 

CURRENT PSW 


To display: 

1 . Type P into the alter/display picture. 

2. Press ENTER. 

The current PSW is displayed in binary notation, except for the 
instruction address, which is in hex. BC or EG mode is indicated in the 
machine status area, line 14, and in the E-bit in the PSW. 

o BC Mode: The system is in basic control mode when the E-bit 

is zero, 
o EC Mode: The system is in extended control mode when the E-bit 
isl. 


C 

CONTROL 

REGISTERS 


To display: 

1 . Type C into the alter/display picture. 

2. Press ENTER. 

All control registers appear at once. 


K 

PROTECTION 

KEY 


To display: 

1. Type K into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

In the protection key display: 
o The address is in hex. 
o The key is in binary. 

o The reference (R), the change (C), and the protection (P) bits 
are in binary. 


M 

MAIN 
STORAGE 
REAL 


To display: 

1 . Type M into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

The display shows 32 halfwords of main storage at once. The Y characters 
in the format illustration represent, in hex, the main storage address with- 
out its low-order digit. The missing low order digit of the address is shown 
above each leftmost byte of each half word. 


V 

MAIN 
STORAGE 
VIRTUAL 


To display: 

1 . Type V into the alter/display picture. 

2. Type in the address. 

3. Press ENTER. 

The display shows 32 halfwords of virtual storage at once. The R char- 



J*' 
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Examples following the flowchart opposite show the format of the various 
displays and describe error indications where applicable. 

Table D-2 Options for the ALTER/DISPLAY console feature 
(Models 115 and 125) 
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Press MODE SELECT 






Type in A and press 
ENTER 



Specify the display 
required by typing in the 
associated mnemonic 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



If you have a display, selected from the 
Alter/Display set or other service function, 
and then press MODE SELECT, the 
Alter/Display picture will appear. To get 
the mode select picture you have to press 
MODE SELECT twice 



Refer to the list of mnemonics and 
instructions given on the opposite 
page. 



Press ENTER 



D-2-F 



Figure D-2 parts 1 and 2, 
illustrate the displays asso- 
ciated with the mnemonics, 
and describe error indica- 
tions where applicable. 



NO 



o 



Make a note of the required 
instruction address and 
contents displayed. 




To alter any of the dis- 
played contents, move the 
cursor under the first digit 
and type in the new data. 



o 




The first digit can be hexadecimal 
or binary, depending the display 
specified. The new contents appears 
on the line below the original until 
the ENTER key is pressed. 



The original display is replaced to 
display the new contents. 



The last picture of the operating 
system is brought back to the screen 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 115 AND 125 



Error messages 

If logical errors are made while altering 

the current PSW, one or any of the 

following error indications may be 

displayed: 

l.EC-PSW ERROR 

2. INVALID ADDRESS LOADED 

3. ADDRESS NOT TRANSLATE- 
ABLE 

Message 1 indicates PSW rejection, 
which is caused if bit 1 2 of the PSW 
is set to zero. Messages 2 and 3 
indicate that the PSW has been loaded, 
but a program check will occur when 
an attempt is made to continue 
operation. 

Message 3 occurs in case of invalid 
page or segment table address 
specification exception. 



Format of displays and error indications 

The following illustrations show the amount and format of information displayed 
with the associated mnemonic. When a wrong character (either a non-hex or a non- 
binary as the case may be) is entered, INVALID CHARACTER appears. The 
cursor marks the first invalid character. 



GENERAL REGISTERS 



ALTER/DISPLAY GENERAL REGISTERS (HEXADECIMAL) 



0000 0000 1 0000 0000 2 0000 0000 3 0000 0000 



4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 



C 0000 0000 D 0000 0000 E 0000 0000 F 0000 0000 



NEXT ALTER/DISPLAY: A 



o 



FLOATING POINT REGISTERS 



ALTER/DISPLAY FLOATING POINT REGISTERS (HEX) 



0000 0000 0000 0000 



2 0000 0000 0000 0000 



4 0000 0000 0000 0000 



6 0000 0000 0000 0000 






NEXT ALTER/DISPLAY: A 



Current PSW 



ALTER/DISPLAY CURRENT PSW 



SYST.MASK KEY 
0000 0000 0000 



EMWP ILC CO 



PROGRMASK 



INSTRUCTION ADDRESS: 000000 
ADDRESS IN HEX. OTHER DATA IN BINARY 



NEXT ALTER/DISPLAY: A 



Figure D-2, part 1 of 2. Format of the displays for Models 115 and 125. 
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CONTROL REGISTERS 



ALTER/DISPLAY CONTROL REGISTERS (HEXADECIMAL) 



0000 OOEO 1 0000 0000 3 FFFF FFFF 3 FFFF FFFF 
4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 
C 0000 0000 D 0000 0000 E C200 0000 F 0000 0200 



NEXT ALTER/DISPLAY: A 



K PROTECTION KEY 



ALTER/DISPLAY PROTECTION KEY 




ADDRESS: 00002F KEY: 0000 



NEXT ALTER/DISPLAY: A 



Error messages 

INVALID ADDRESS appears if the address 
is larger than the real storage size. 

The address has to be typed in with leading 
zeros. When selecting the alter /display 
protection key display, do not use any 
commas or blanks. 



MAIN STORAGE REAL 



ALTER/DISPLAY MAIN STORAGE REAL (HEXADECIMAL) 



02468ACr 
00012 0000 0000 0000 0000 0000 0000 0000 0000 



00013 0000 0000 0000 0000 0000 0000 0000 0000 

00014 0000 0000 0000 0000 0000 0000 0000 0000 



00015 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



V ALTER/DISPLAY MAIN STORAGE VIRTUAL 



■ 1 



ALTER/DISPLAY MAIN STORAGE VIRTUAL (HEX) 



REAL: 03E28 2 4 6 



61A94 D0E3 AB13 5478 4ABE 0000 0000 0000 0000 



61A95 0000 0000 0000 0000 0000 0000 0000 0000 



61A96 0000 0000 0000 0000 0000 0000 0000 0000 



61A97 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Figure D-2, part 2 of 2. Format of the displays for Models 115 and 125 



Error messages 

If the contents of the virtual address 
entered is not in real storage the 
virtual storage area will not be 
displayed. Instead one of the following 
messages will be displayed: 
OUTSIDE PAGE TABLE 
OUTSIDE SEGMENT TABLE 
PAGE ENTRY INVALID 
SEGIVIENT ENTRY INVALID 
SPECIFICATION EXCEPTION 
ADDRESSING EXCEPTION 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODEL 158 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the CPU (Central Processing Unit), and of real 
or virtual storage areas: 



General registers 
Floating-point registers 
Current PSW 
Control registers 
Protection keys 
Real storage areas 
Virtual storage areas 



Real Channel UCWs 
Logical Channel UCWs 
Active UCWs 
CPU Local Storage 
I/O UCW Local Storage 
I/O Buffer Local Storage 



V 
^ 



How to use 

The ALTER/DISPLAY frame, shown below, can be entered only from the 
MANUAL or SERVICE frame when the CPU is in the stopped (manual) state. 







A procedure for using this facility is shown in the flowchart on the opposite page. 

Error Indications 

All address characters are checked as they are entered for hex values 0-F. 
Invahd characters are not displayed and the console alarm sounds. 

If the cursor stays in the reset position (under the Y in Key In/ Address) and if the 
console alarm sounds, an invalid function code has been entered. A valid function 
code must be entered before the cursor will reposition to the right (one position). 

Printing displayed information 

A "hard copy" of all information displayed can be obtained on a Model 158 with 
a 3213 printer attached by pressing the COPY key after the information is displayed. 

Note however, that the following frames cannot be printed: 

• PROGRAM 

• ALTER/DISPLAY 

• INDEX 

(and when using the ALTER facility, only lines that have been changed by entering 
new data will be printed on the 3213 printer.) 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for dxample a program using MICR or teleprocessing as input 
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Aids provided by the Operator's console 



o 







If the function requires 
an address the cursor 
moves to the first digit 
under KEY IN/ADDRESS 
(see the note below) 

The cursor moves to 
the right until the 
address is complete 

The cursor will pos- |ij 
ition itself under the ^J 
first digit of the con- ^J 
tents of the location |^| 
at the specified address p* 

The cursor will pos- Ife, 
ition itself at the next ^f 
digit that can be altered i|P'- 



Press STOP, 

then 

Press MODESEL 



ALTER/DISPLAY 
MODEL 15a 



Type in F3, or press 
light pen to lozenge. 
3-ALTER/DISPLAY 



ALTER 




The MANUAL frame will be 
displayed 

The ALTER/DISPLAY frame 
will be displayed as shown on 
the opposite page 



DISPLAY 



Type in A or press 
light pen to lozenge 
■ A-ALTER 



Type in the associated 
mnemonic for the 
function to be altered, or 
use the light pen. 



Type in an address or 
use the light pen 



Press ENTER or COPY, 
or use light pen 



Type in new data or 
use the light pen. 



Press ENTER, or COPY, 
or use light pen. 



Type in D or press 
light pen to lozenge 
■ D-D ISP LAY 



Type in the associated 
mnemonic for the 
function to be dis- 
played, or use the 
light pen. 



If locations are to be 
displayed type in, or use 
light pen to enter the 
address in six hex digits 



I If the function requires 
fan address the cursor moves 
|to the first digit under KEY 
I IN/ADDRESS (see note 
I below) 



I The cursor moves to the 
|right until the address is 
icomplete 




Press ENTER, or COPY 
or press light pen to 
lozenge ■ COPY. 



Yes 



Press CANCEL 





Note 1: 

An address is not required to 

alter or display the following: 

• Control registers 

• General purpose registers 

• Floating point registers 

• Program status word 



\The program frame 
I displayed prior to this 
I operation is re-displayed 



Press START 



J 






l/Vhen using COPY and ENTER: 

Using COPY will only produce a "hard copy" of lines that have been changed by entering new data. 

Using ENTER in display mode will not produce a "hard copy". 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
(ALL MODELS) 



This console facility allows the operator to check and obtain a hard copy of each 
instruction address executed during program operation. 

Combining this facility with the console printer ALTER/DISPLAY feature 
described in D-1 of this section, provides a procedure to trace and record the path 
of a short loop. 

Note: The different types of loops and their causes are described in Section 1. 



When to use (all Models) 

This facility should be used when the system malfunction prevents the use of 
SDAIDS to trace the loop. It is also useful during hands-on debugging when only 
small parts of a program require accurate program flow analysis. 

Flowcharts in Section 3 indicate to the operator when a loop is to be traced using 
this console facility. 



INSTRUCTION STEPPING 
MODELS 135, 145, 
AND 155-11 



How to use 



A procedure for tracing and recording the path of a loop using the instruction step 
facility of the Models 135, 145 and 155-11 is shown in the flowchart opposite. 



KJ 
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Aids provided by the Operator's Console 

INSTRUCTION STEPPING 

MODELS 135, 145, 

AND 115-11 



Start 



Press STOP and wait until 
MAN indicator turns on 



Set RATE switcii to 
INSTRUCTION STEP 



\J 



Press ALTER /DISPLAY 
(printer-keyboard) and 
wait until PROCEED light 
(printer-keyboard) turns on 



Carrier return and line feed occurs. ALT/DISP 
MODE light (printer-keyboard) turns on. 
If this does not occur, press CANCEL on the 
printer-keyboard, and press the ALTER/DISPLAY 
key again. 




Type in DP 
press END 



The contents of the current PSW 
is printed 




NO 



Press START and wait until 
SYS indicator turns off 



Set RATE switch 
to PROCESS 



To continue system 
operation, press the 
START key 



The procedure for tracing a loop using instruction step method 
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Aids provided by the Operator's Console 

How to use 



INSTRUCTION STEPPING 
MODELS 115 AND 125 



INSTRUCTION STEP 

offers two modes: 
landP 



The INSTRUCTION STEP display allows the operator to check and make a note 
of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

To select the instruction step display shown below: 

1. Type I into the mode select display. 

2. Press ENTER. 






INSTRUCTION STEP 



OPERATION RATE 

I INSTRUCTION STEP 
P PROCESS 



I INSTRUCTION STEP 



P PROCESS 



.If I is typed into the instruction step display and ENTER is pressed, the new data 
can be seen as soon as the stop occurs. Line 14 (in the machine status area) shows 
the address and the data at this address. 

.As soon as START is pressed the screen is returned to the operating system and 
operating messages can be traced with each step. Instruction step mode is indicated 
by I-STEP on line 15 (in the machine status area). Entering P is used to end the 
instruction step mode. 

1. Type in P. 

2. Press ENTER 

The last picture of the operating system is brought back to the screen. 
Press START to continue processing. 



O 
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Aids provided by the Operator's Console 

INSTRUCTION STEPPING 
MODELS 115 AND 125' 



Press MODE SELECT 



Type in II and press ENTER 






The machine stops and the previous 
display disappears 



Press START 
Wait until MAN appears 
on line 13 and l-STEP 
appears on line 14 



When START is pressed, the instruction 
step display disappears and the screen 
is returned to the operating system. 
For each depression of START, one 
machine-language instruction is processed. 
CPU then services any pending 
interruptions before entering manual state. 



Make a note of the 
instruction address and con- 
tents displayed on line 14 



Yes 





No 



Press MODE SELECT 



Type in IP and press 
ENTER 



(Fast Selection) 

Instruction step mode is cancelled. 



To resume processing 
press START 



The procedure for tracing a loop using the instruction step method 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
MODEL 158 



The INSTRUCTION STEP display allows the operator to check and make a note 
of, or obtain a "hard copy" of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

How to use 

With the manual fram displayed, shown below, after pressing MODE SEL, the 
R-RATE switch must be set to I-STEP by either typing in R2 or by pressing the 
light pen to lozenge ■ 2-I-STEP. The selection is indicated by an arrow displayed as 
shown in the example below. 







The instruction address of the current instruction will be in the address part of 
the PSW displayed on line 25. 

Pressing the START key will cause the CPU to execute the next instruction in 
logical sequence, the address of which will be displayed in the PSW as before. 

In display mode of operation a "hard copy" of the PSW displayed can be obtained 
on the 3213 printer, if attached, by pressing the COPY key or by pressing the 
light pen to lozenge COPY. 

To return to normal CPU processing rate, type in Rl or hold the light pen against 
■ 1 -PROCESS and press MODE SEL followed by START. 
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Aids provided by the Operator's Console 



^^^It^^ 



INSTRUCTION 

STEPPING 

MODEL 158 



c 



Press STOP 



3 



Press MODE SEL 



The MANUAL frame is 
displayed 



Type in R2, or press 
light pen to lozenge 
■ 2-l-STEP 



O 



Press START 



Press COPY 

or press light pen 

to lozenge ■ COPY 



The word SYS will be displayed 
momentarily, and the instruction 
address will be displayed in the 
PSWon line 25 



A "Hard copy" of the frame 
displayed can be obtained on 
the 3213 printer, if attached 



Yes 





No 



Type in R1 or press 
light pen to lozenge 
■ 1 -Process 




Yes 



No 



Press MODE SEL 
or CANCEL 



Select new mode 



C 



Press START 



J 






The procedure for tracing a loop using the instruction step method on the Model 158 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 

COMPARE 

(ALL MODELS) 



This facility enables you to stop all system activity at any selected storage address 
during system operation. Two methods are provided on the System/370 that 
enable both hardware and software-controlled stops: 

1. By using switches on the system control panel 

2. By using the SDAID stop on event facility. 

For the Models 145 and 155-1 1 the system control panel switches enable a stop 
on real or virtual address. 

The Model 115, 125 and 135 have system control panel switches that do not allow 
for a stop on a virtual address. 

Stop on event for all models is described under SDAIDS, Section 2-B-8. A flow- 
chart in Section 2-B- 10 shows how to initiate and execute this aid. 



o 



When to use (all Models) 

This facihty is a hands-on debugging aid for the programmer, and permits him to 
stop system operations at selected addresses in the program listings. He can use it, 
for example, in conjunction with either the ALTER, DSPLY and DUMP commands, 
or the console ALTER/DISPLAY feature, to change the contents or display 
particular areas of storage at selected addresses in a program. The operator is also 
able to use this facility if, for example, the programmer requests a dump of 
certain storage locations at particular points in a program during execution of 
the program. 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 115-11 



How to use 

Four switches on the system control panel are used during address compare 
operations: 

• ADDRESS COMPARE CONTROL (Toggle) 

• ADDRESS COMPARE (Rotary) 

• STORAGE SELECT (Rotary) 

• INTERVAL TIMER (Toggle) . 

The flowchart opposite shows the procedure for stop on address compare appHcable 
to System/370 Models 135, 145 and 155-1 1 . However, because the ADDRESS 
COMPARE rotary switch differs between models, the IBM operating procedures 
for the model on which the operation is to be executed must be consulted. 

The flowchart on the following page shows how to invoke the displays required 
to execute the "Stop on Address Compare" on the Models 115 and 125. 



("' 



^ 
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Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 






Start 



) 



Press STOP 



\ 



Ensure STORAGE SELECT 
is set to MAIN STORAGE 



Set INTERVAL TIMER 
to DISABLE 



Set rotary switches A 
through E (STORAGE ADD- 
RESS) to desired stop 



Set ADDRESS COMPARE 
to select desired condition 
for stop, for example, ANY 



Set ADDRESS COMPARE 
CONTROL three-position 
lever switch to STOP 



Press START 



, Address 
y Comparison 
Stopping 



Switch positions for selecting the 
conditions for the stop are different for 
each of the Systenn/370 Models. Consult 
Compare Type Selection on the next 
two pages and the note below. 



Model 135 and 145 
When address accessed by 
CPU matches selected address 
CPU stops at the end of in- 
struction in progress. 



Set: 

1. ADDRESS COMPARE 
to ANY 

2. ADDRESS COMPARE 
CONTROL to SYNC/ 
NORMAL 

3. INTERVAL TIMER to 
NORMAL (if required) 



Press START 




> 



Resumption 
of 

Normal 
Processing 



Note: 

See ADDRESS COMPARE and 
ADDRESS COMPARE CONTROL 
CONTROL switch setting for each 
System/370 model as described in the 
IBM-supplied Operating Procedures 
manual belonging to the system. 



J 



A procedure for using the stop on address compare facility. 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 145, 
AND 155-11 



Compare type selection (Model 135) 



ADDRESS COMPARE 



ANY 




DATA STORE: 

A match occurs when the selected location is addressed to store data. 

ANY: 

The normal operating position — a match occurs when the selected location is 

addressed for any type of operation 

IC: 

A match occurs when the selected location is addressed by an instruction 

I/O: 

A match occurs when the selected location is addressed for an I/O data transfer 



Compare type selection (Model 155-11! 



I ADDRESS COMPARE 

ANY 
FETCH 0^,^-iV-s.o lAR 



STORE 




ANY (Real Address) 

This position of the switch is used for normal program processing. With the switch 
in this position, a match occurs for main storage access when the storage address 
matches the address set in console switches CDEFGH. 

FETCH 

This position causes a match when the storage address matches the address set in 
console switches CDEFGH, and the operation is a data fetch from main storage. 

STORE 

This position allows a match when the storage address matches the address set in 
console switches CDEFGH during a data store operation. 

lAR 

This position of the switch allows a match when the lAR (instruction address 
register) address matches the address set in console switches CDEFGH. 

I/O (Input/Output) 

This position of the switch allows a match when the storage address matches the 
address set in console switches CDEFGH, and the operation is a data store or fetch 
for an I/O operation. 



\^y 
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Compare type selection (Model 145) 
ANY (Logical Address) 

This position of the switch allows a match when the logical 
main storage address used to access storage matches the 
address set in console switches CDEFGH. 

ANY (Real Address) 

This position of the switch is used for normal program 
processing. With the switch in this position, a match occurs 
for main storage access when the storage address matches 
the address set in console switches CDEFGH. 

DATA STORE 

This position allows a match when the sotrage address 
matches the address set in console switches CDEFGH during 
a data store operation. 

I/O (INPUT/OUTPUT) 

This position of the switch allows a match when the storage 
address matches the address set in conssole switches 
CDEFGH, and the operation is storing or fetching data for 
an I/O operation. 

I-COUNTER (Real or Logical Address) 

This position causes a match when the real or logical main 
storage address matches the address in console switches 
CDEFGH, and the operation is an instruction fetch from 
main storage. 

NOTE: Significant tt) rough put degradation can occur wtiile processing wit/i tliis 
switct) set to tiie I-COUNTER REAL ADR position. 



Data compare trap (Model 145) 

This facility is useful during hands-on debugging to determine what instruction is 
causing a particular storage byte location to be modified. 

1. Press STOP. 

2. Set the ADDRESS COMPARE switch to DATA COMPARE TRAP. 

3. Set the address of the storage byte location being modified in console 
switches CDEFGH. 

4. Set data switches A and B to the desired byte match value. 

5 . Set the ADDRESS COMPARE CONTROL toggle switch to STOP. 

6. Press START. 

When a store operation modifies the specified storage byte location to the value set 
in switches A and B, the ADR COMP MATCH indicator is turned on and the CPU 
enters a soft-stop state. 

To determine the address of the instruction that modified the storage byte, display 
the current PSW, and subtract the current instruction length code from the 
instruction address in the current PSW. 



Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 135, 145, 

AND 155-11 



ADDRESS COMPARE 



ANY 
LOGICAL , 
ADR 
I COUNTER 

CTRL WORD* 
ADR 
CTRL WORD • 
TRAP 




•DATA STOR 



•l/O 



REALl 
ADR 



• I COUNTER 

DATA COMP 
TRAP 




o 



Note: 

Tiie instruction found with this procedure may not have modified the data. An 

I/O data trap occurring during execution of this instruction could have modified 

the data. To determine which IfO data trap modified the data, log the address 

displayed in the A-Register Display roller switch indicators and call your service 

representative. 
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STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



How to use 

Before this facility can be used the mode select display must be brought to the 
screen by pressing the MODE SELECT key. 

To select the storage ADDRESS COMPARE display shown below: 

1. Type in 'C beside MODE SPECIFICATION on the mode select display. 

2. Press ENTER. 



Error Indications 

If you make an error when typing in 
the code or hex characters: 

• The address compare display stays 
on the screen. 

• INVALID CHARACTER appears. 

• The cursor marks the location of the 
first error. 

The display remains on the screen 
as long as an entry error has not been 
corrected. When there is no error, 
the display disappears after ENTER 
is pressed. 



MAIN STORAGE ADDRESS COMPARE 



P PROCESS 



COMPARE TYPE 



D DATA STORE 



C IIMSTR.COUNT 



STORAGE ADDRESS 



000000- FFFFFF 



Three columns are displayed and an entry must be made under each column. 



S 
Y 



STOP: the machine stops when the address has been found. 

SYNC: a signal for the customer engineer is given when the address has been 



ACTIONS 

[^ found. 

P PROCESS: address compare mode is turned off and normal processing continues. 

A ANY: the CPU will compare your search address (the address you type into 
column three) against all addresses used in the system. 

D DATA STORE: the CPU will compare your search address against only those 
storage addresses used to store data. 

Your search address will not be compared against addresses used in transferring 
data to or from I/O devices. 

I I/O DATA: the CPU will compare your search address against only those 
storage addresses used in transferring data to or from I/O devices. 

C INSTR COUNT: the CPU will compare your search address against only those 
STORAGE ADDRESS^ addresses used when fetching instructions. 

The real storage address at which the stop is to occur. 



COMPARE TYPE < 



\^ 



^du-j"*^ 
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o 



Press MODE SELECT 



#%. 



The machine stops and the display 
disappears. 



Type in Cand press 
ENTER 



Type in S (or Y) 



Type in code for type 
of data to be compared 



Type in real storage 
address (6 hex digits) 



Press ENTER 



Processing continues until 
address is found. Then 
System stops. 



Press START 



IVIake a note of the data 
displayed on line 15 




YES 



Press MODE SELECT. 
Type in OP. 
Press ENTER. 



To resume processing 
press START 



Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



Y is for CE use only. 



Codes are: 
A = ANY 

D = DATA STORE 
1=1/0 DATA 
C = INSTR COUNT 



(See the description 
of the codes on the 
opposite page) 



Addresses outside the real address area cause 
message INVALID ADDRESS to be displayed 



Address compare display is replaced but 
specifications entered are displayed on line 14 
of the new display 



• The last operating message stays on the 
screen. 

• MAN appears. 

• The addresses on lines 14 and 1 5 are the 
same. 




Stop on Address Compare mode is 
cancelled 



Fast Selection: You can type your specifications for address compare directly 
into the mode select picture. For example, you can type CSC005FAC, without 
commas of blanks to specify Compare with action Stop during instruction 
fetching with address 005FAC. 
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STOP ON ADDRESS 
COMPARE 
MODEL 158 

STOP ON A REAL ADDRESS 



COMPARE TYPE 

Note: If STOP is not selected 
a 'sync' pulse will be generated 
on true comparisons and the 
CPU will not stop. 



STOP ON A VIRTUAL 
ADDRESS AND DATA 
COMPARE TRAP 



How to use 

Before this facility can be used the MANUAL frame must be brought to the screen 

by pressing the MODE SEL key. 

To stop on a real address S-SAR COMP SEL(REAL) must be used in conjunction 
with E-SAR COMP SEL(REAL). 

1. Select the STOP function ■ 5-STOP or type in S5 

2. Select the compare type (see below) 

3. Enter a real address at E-SAR COMP SEL(REAL). 

A stop will occur on any quadword boundary of a selected real address 

1-ANY: the CPU will compare the address set under E with all addresses used in the 
real addre ss area. When a true comparison is met the CPU will stop. 
2-STORE: causes the CPU to stop when a STORE operation is performed on the 
location at the address entered under E. 

3-FETCH: causes the CPU to stop when a FETCH operation is performed on the 
location at the address entered under E. 

^ 4-1/0: causes the CPU to stop when data is transferred either to or from the 
location at the address entered under E. 

The example below shows the appearance of the manual frame after selecting a 
stop on a FETCH operation on the location at real address 007FF8. 



O 




A facility on the System/370 Model 158 allows a stop on a virtual address with a 
maximum of 6 conditions described in the table below. 



FUNCTION 


CPU ACTION 


USAGE 


G1 -STORE 
G2-IAR 


Stops processing after a store to the virtual address specified 
in ADR1. 

Stops processing after an instruction fetch to the virtual 
address specified in ADR1 . 


The cursor can be backed up under the digit to the left of the 
period and the base register entered in that position. The six 
digits to the right of the period are used to contain the dis- 
placement. The DATA fields and the ADR2 and ADR3 fields 
can be used to further define the stop conditions, giving a 
maximum of six conditions that must be satisfied before a 
stop occurs. The C to the left of the period in the data field 
signifies that the specified data vuill be compared. When the 
C is changed to a 1 , the specified bits are compared. 

Exampie: If the character to the left of the period is changed 
to a 1, and 1A is entered in the DATA field, a stop occurs 
whenever bits 3, 4, and 6 are on. Conversely, if the C is 
changed to a 0, a stop occurs whenever bits 3, 4, and 6 are 
off. 


H1-ADR1 
H2-DATA 


Specifies the first condition that must be met in order for 
a stop to occur. 

Specifies the data that must be found at the address in 
ADR1 for a stop to occur. If DATA is not pressed, the stop 
occurs whenever the location specified by ADR1 is 
addressed. 


H3-ADR2 
H4-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 


H5-ADR3 
H6-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 
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Press STOP 



Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODEL 158 



Press MODE SEL 



Type in S5 or press 
light pen to lozenge 
■ 5-STOP 



The manual frame will be displayed 



I If STOP is not selected, a sync pulse 
only is generated on true comparison 
for use by the IBM CE 



Type in a code number 
or use the light pen, to 
specify the type of 
compare required 



Type in a six digit 
addresss in hexadecimal, 
or use the light pen at HEX 
INPUT on the display. 



Press ENTER or COPY 



Processing continues 
until address is found. 
Then System stops. 



Press START 




Yes 



Press CANCL 



To resume processing 
press START 



Codes are: ^ 

1-ANY I I see the description 
2-STOR E I J of the codes under 
3-FETCH f S COMPARE TYPE 
4-1/0 I Ion the opposite Rage. 

The address will be displayed as 
it is entered at E-SAR COMP 
SET (REAL) The address 
specified must be within the 
real address area 



Using Copy will cause the entire 
manual frame to be printed on 
the 3213 printer 



The word MAN will be 
displayed at the lower right 
corner of the display 



The manual frame is replaced 
by the program frame 
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CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



This operation provides a non-destructive readout and printout of any real storage 
area (up to 64K bytes at a time). The command can be executed at any time, and 
the (dumped) program can continue as soon as dumping is completed (no IPL or 
restart required). 
To select the storage dump display: 

1. Type D into the mode select display. 

2. Press ENTER. 

The display shown below appears on the screen. 



MAIN STORAGE DUMP 



Error Indications: 

PRINTER NOT READY appears 
if ttie line printer is not ready. 
STORAGE END appears if the 
start address is greater tiian the 
physical size. 

INVALID CHARACTER appears 
for any non-hex digits. 
INCOMPLETE ENTRY appears 
when necessary. 



ENTER START ADDRESS: 00 03 00 
END ADDRESS: ** 12 FF 



STORAGE END 



How to use 

1. Type in the start and end addresses. Remember that: 

• The low order halfword must be two zeros. 

• The end address must be within 64K bytes from the start address, and the 
low-order halfword must be FF. 

• If the dump required is more than 64K bytes, repeat the operation with 
a new start and end address. 

2. Press ENTER. 

• Dumping can be stopped at any time by pressing MODE SELECT, CANCEL, 
or START. If one of these keys is pressed, DUMP CANCELLED appears on 
the screen. 

• DUMP COMPLETE appears on the scrren when the selected dump range has 
been printed. 

• STORAGE END appears on the screen when the upper boundary of storage 
has been reached. 

The flowchart shown on the opposite page shows the procedure for using this 
command. 






When to use 

This is a useful aid to use when large areas of real storage must be recorded for 
later analysis. It can also be used instead of the ALTER/DISPLAY feature to 
record low address storage before executing the stand-alone dump program. 



o 
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Aids provided by the Operator's Console 



Press MODE SELECT. 
Type in D. 
Press ENTER. 






CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



Ready the 
Line printer 



Enter the starting and 
ending addresses in hex 



Press ENTER 



The end address cannot be 
more than 64K fronn the start 
address 



Dumping begins 



Press MODE SELECT 
CANCEL, or START. 




DUMP CANCELED 
is displayed 



Press CANCEL 



The dump display disappear. 



To resume processing 
Press START 



Processing continues 



NOTE: If a log or retry operation takes place at the same time as a 
dump request, PRESS CANCEL appears on the screen. After pressing 
CANCEL, the message LOG IN PROGRESS appears in the machine 
status area. You can repeat clumping as soon as the log message 
disappears. 



D 10 F 



o 
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STORE STATUS 
(ALL MODELS) 



This function enables certain control information to be stored and preserved for 
analysis by the IBM CE. 

Models 135, 145 and 155-11 

1. Press the console printer keyboard ALTER/DISPLAY key. 

2. Type in ST. 

The information saved is identical to that listed below for the Model 125 



Models 115 and 125 

There is no display for STORE STATUS. 
To store the status: 

1. Type S into the mode select display. 

2. Press ENTER. 



O-OPERATOR FUNCTIONS 
1-PSW RESTART(PRGM) 
2-RESTART(PRGM) 
3-SYSTEM RESET 
4-LOAD 

5-STORE STATUS 
6-SYS REST (CLEAR) 
7-LOAD(CLEAR) 



1- 


LOAD UA 
000 


W-SWAP 
SAR 13 


X 


-EXECUTE 
OPERATOR FUNCTION 



> < 



The following information is stored. 

• CPU Timer 

• Clock Comparator 

• The current PSW 

• Floating-Point Registers 

• Control Registers 

• General Registers. 

After ENTER has been pressed: 

• The mode select display remains on the screen and STATUS STORED appears. 

• The system goes into the stopped state . 

• The S has disappeared from the mode specification field, so this field is free 
and another operation can be specified. 

Note: This function must not be used on a Model 115 or 125 that does not support 
MCH (Machine Check Handling). 

^Model 158 

1. Press MODE SEL to obtain the manual frame. 
' 2. Type in 03 or hold light pen against ■ 3-SYSTEM RESET. 

3. Type in X or press light pen to lozenge ■ OPERATOR FUNCTION. 

4. Type in 05 or press light pen to lozenge ■ 5-STORE STATUS. 

5. Type in X or use light pen at ■ OPERATOR FUNCTION. 

A new function may now be selected. 

When to use 

This function should be used before executing the stand-alone dump program. 
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Models 135, 145 and 155-11 

Real storage can be cleared to zeros by the following procedure: 

1. Press and hold in ENABLE SYSTEM CLEAR. 

2. Press SYSTEM RESET or LOAD. 

3. Re-IPL to continue processing new job. 
Note: Control storage is unaffected. 



Aids provided by the Operator's Console 

CLEAR REAL STORAGE 
(ALL MODELS) 



o 



Models 115 and 125 

1. Press the MODE SELECT key. 

2. Type RC into the mode select display. 

Note: AtlPL time one of the LOAD parameters is NORMAL or CLEAR 

Model 158 

Two methods are available on the Model 158 to clear real, or main storage. 



1 



System Reset (Clear): In addition to performing the reset function, this causes 
main storage and the storage-protect arrays to be validated (cleared to zeros with 
good parity). 

Press MODE SEL to obtain the manual frame. 

Type in 06 or hold light pen against ■ 6-SYS RESET (CLEAR). 

Type in X or hold light pen against ■ OPERATOR FUNCTION. 



2. Load (Clear): In addition to performing the load function, this causes the IPL 
function to be preceded by an initial program reset, and clears main storage and 
the storage-protect arrays. 

• Press MODE SEL to obtain the manual frame 

• Enter a load unit address 

• Type in 07 or hold the light pen against ■ 7-LOAD (CLEAR). 

• Type in X or use light pen at ■ OPERATOR FUNCTION. 



When to use 

This facihty should be used with caution. An example of its use is to reset the 
hardware after a machine check is caused by a parity error in real storage. It must 
be used after you have gathered all the information from the system. 
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Aids provided by the Operator's Console 



SAVE USAGE COUNTERS 



There is no display for SAVE USAGE COUNTERS. 
To select the save usage counters operation: 

1. Type U into the mode select display. 

2. Press ENTER. 

When to use 

This operation saves the usage counters of all disk drives. The operation should 
always be performed before you turn the power off so that the information can be 
used by the CE for maintenance. The message 'counter saved' appears for each 
counter that is recorded. 






o 
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Other Aids 

JOB CONTROL 
COMMANDS AND 
STATEMENTS 



The following commands and statements are not primarily designed as 
serviceability aids, but enable useful information to be obtained from the system 
during program execution. 

For example, it is useful to place the LISTIO statement and command in job 
streams where device assignments are suspected of causing errors. The LOG 
command enables you to record job control statements and commands issued 
during a job, and the MAP command enables you to check partition allocation. 
These three commands, LISTIO, LOG, and MAP can be used therefore as a "job 
stream trace," as shown in the example opposite. 

In certain cases of system malfunctions, this information, used in conjunction with 
dumps and trace routine output, will help during offline debugging. 



LISTIO or// LISTIO 

The LISTIO command or statement (List I/O Assignment) causes the system to 
print a listing of I/O assignments. The listing appears on SYSLOG (command) or 
SYSLST (statement). If SYSLST is not assigned, the LISTIO statement is ignored. 



Statement Format 



II LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLST) 



Command Format 



LISTIO 



SYS 

PROG 

BG 

F4 

F3 

F2 

F1 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYSLOG) 



The table following the example opposite explains the meaning of the LISTIO 
options. 
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Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 



o 





An example of a "job stream trace" using the LOG, MAP, LISTIO and PAUSE 
commands and statements. 
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JOB CONTROL 
COMMANDS AND 
STATEMENTS 



Options for LISTIO 



Options 


Meaning 


SYS 


Lists the physical units assigned to all systenn logical units. (See note.) 


PROG 


Lists the physical units assigned to all background progrannmer logical units. (See note.) 


BG 


Lists the physical units assigned to all background logical units. 


F4 


Lists the physical units assigned to all foreground-one logical units. 


F3 


Lists the physical units assigned to all foreground-two logical units. 


F2 


Lists the physical units assigned to all foreground-three logical units. 


F1 


Lists the physical units assigned to all foreground-four logical units. 


ALL 


Lists the physical units assigned to all logical units. 


SYSxxx 


Lists the physical units assigned to the logical unit specified. The assignment is given for the partition fronn 
which the command is given. (See note.) 


UNITS 


Lists the logical units assigned to all physical units. (See note.) 


DOWN 


Lists all physical units specified as inoperative. (See note.) 


UA 


Lists all physical units not currently assigned to a logical unit. 


X'cuu' 


Lists the logical units assigned to the physical unit specified. 



c 



Note: Physical units are fisted with current device specification for magnetic tape units. Logical units are listed with ownership 
(background, or any foreground), when applicable. If a unit has a standard assignment in one mode and a temporary assignment 
in another mode, the CMNT column identifies the type of assignment for each indicated mode. All channel unit numbers are 
represented in hexadecimal. 

LOG 

The LOG job control command causes the system to log, on SYSLOG, columns 
1-72 of all Job Control commands and statements occurring in the batched-job 
partition in which the LOG is issued. The AR LOG affects all the partitions. The 
LOG function is effective until a NOLOG command for the partition involved is 
sensed. 

The format for the LOG job control command via attention routine is as follows: 
LOG blank 

The operand field is ignored by the system. 

NOLOG 

The NOLOG command (suppress logging) terminates the listing, on SYSLOG, of 
Job Control commands and statements (except JOB, PAUSE, STOP, ALLOC, 
MAP, HOLD, RELSE, UNA, DVCDN, DVCUP, *, and /&) that occur in the 
batched-job partition in which the NOLOG is issued. The NOLOG function is 
effective until a LOG command for the partition involved is sensed. 

The format for the NOLOG job control command via attention routine is as 
follows: 

NOLOG blank 

The operand field is ignored by the system. 
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Page of GC33-5 380-1, 
revised June 30, 1974, 
by TNL SN33-8780 



^'^\t\ 



MAP command 

The MAP command produces on SYSLOG a map of virtual storage areas allocated 
to programs. 

An example of the output produced on the console printer is shown below: 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 







IH 










HHI 




^HHH 








F2 


map 


















• 


F2 
F2 
F2 


AREA 
SP 


K- 


-REAL 
92K 


UPPER LIMIT 
94207 


K-VIRT 


UPPER LIMIT 
262144 


NAME 






• 


F2 


BG 


V5A 


30K 


124927 


292K 


561151 


KENSLOOP 






F2 


F4 


14 


lOK 


135167 


80K 


643071 










F2 


F3 


U3D 


lOK 


145407 


80K 


724991 








• 


F2 


F2 


V2A 


14K 


159743 


lOOK 


827391 


NO NAME 






F2 


Fl 


11 


82K 


243711 


120K 


950271 










F2 


SVA 








96K 


1048575 








• 


F2 


VIS 








68K 


1048575 








F2 


PP 




18K 


262143 






^^^^^x5a*T 








■1 










■1^1 




i^lHB 








SP = Supervisor, V = Virtual, PP = Main Page Pool, 1 = Inactive, SVA = Shared Virtual Area, R = Real, 
A = Active, D=Deactivated 

1 , 2, 3, 4, 5 = Partition Priority (1 = highest priority), VIS = Amount of SVA reserved by GETVIS 
parameter of the VSTAB system generation macro 


K-REAL 


gives the number of bytes allocated to the real partition or the number of bytes of the main page pool. The size 
is given in multiples of 2K. 


UPPER LIMIT 


shows the highest storage addresses in decimal of the respective real partition, of the supervisor, and of the main 
page pool. 


K-VI RT 


specifies the number of bytes allocated to the respective virtual partition. The size is given in multiples of 2K. 
This field is blank for the supervisor and for the main page pool. 


UPPER LIMIT 


contains the highest storage address in decimal of the respective virtual partition. For the supervisor, this field 
specifies the start address of the virtual address area. This field is blank for the main page pool. 


NAME 


contains the name of the job which is currently executing in the corresponding partition. This field is blank for 
the supervisor, SVA, VIS, and for the main page pool. When the listing shows NO NAME for the background, 
or when the name field is blank for a foreground partition, no program is being executed in that area. However, 
the name field for any partition contains NO NAME when no job control statement or command was entered, 
but the program is active. 



Note: If a program issues an SVC55, some page frames in the main page pool (PP) will also belong to that program. Therefore to calculate 

the total area in real storage occupied by that program, the MAP command should be issued before running it. The difference between 

the number of K in the PP before running the program, and the number of K during the execution of the program is the amount of K 

seized by the SVCS5. 

This also applies when PDAID output mode is an alternate area or the SDAID is initiated. 

In this case, the area occupied by the PDAID or SDAID is printed during their initialization. 

Note: The output does not indicate storage temporarily added to the page pool as a result of using the SIZE parameter of the 
EXEC statement. 
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COMMANDS AND 
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OPTION 

The OPTION statement specifies one or more of the Job Control options. The 
format of the OPTION statement is: 

JCS Format 

//OPTION option 1 (,option2,...) 

The options that can appear in the operand field follow. Selected options can be 
in any order. Options are reset to the standards established at system generation 
time upon encountering a JOB or a /& statement. 

DUMP Causes a dump of the registers and main storage to be output on 
SYSLST, if assigned, in the case of an abnormal program end. (See 
A-2 in this section for a full description.) 

NODUMP Suppresses the DUMP option, if the latter was specified in the STDJC 
macro during system generation. 

LOG Causes the Hsting of columns 1-80 of all control statements on 

SYSLST. Control statements are not listed until a LOG option is 
encountered. Once a LOG option statement is read, logging continues 
from job-step to job-step until NO LOG option is encountered or until 
either the JOB or /& control statement is encountered. 

NO LOG Suppresses the listing of all valid control statements on SYSLST until 
a LOG option is encountered. If SYSLST is assigned, invalid 
statements and commands are listed. 

LIST Causes language translators to write the source module listing on 

SYSLST. In addition, it causes the Assembler to write the hexadecimal 
object module listing and causes the Assembler and the FORTRAN 
compiler to write a summary of all errors in the source program. All 
are written on SYSLST. 



X,,, 



NOLIST Suppresses the LIST option. 



PAUSE 



The PAUSE command causes a pause at the end of the current job step. The 
PAUSE Job Control statement causes a pause immediately after processing this 
statement. At the time, SYSLOG is unlocked for message input. END (on the 
Models 135 and 145) or ENTER (on the Model 125) causes processing to continue. 
The PAUSE statement or command always appear on SYSLOG. If a 3210 or 3215 
or video console display unit is not available, the PAUSE statement or command 
is ignored. 



c 
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, Other Aids 

' This is an area of real storage, starting at byte address 000000, and permanently LOW ADD R ESS 

reserved for use by the supervisor. STO R AG E 

For the purpose of program debugging, lov^ address storage extends up to byte 
address 160 decimal (X'BF') 

Displaying low address storage 

Low address storage will always be dumped during the execution of: 

• A stand-alone dump; see A-2 in this section. 

• A system dump; see A-2 in this section. 

• A transient dump (bytes 0-144 hex); see A-4 in this section. 

Low address storage can also be dumped by means of DUMP or DSPLY operator 
commands (see A-1 in this section), or the ALTER/DISPLAY feature on the 
console printer or display unit keyboard (see D-1 in this section). 

When to display 

• Low address storage must be dumped by using the ALTER/DISPLAY 
console printer feature whenever a hard wait is recognized. 

• When a system malfunction is recognized in one of the programs in a 
multiprogramming or teleprocessing environment, low address storage must 
be dumped by using the DUMP or DSPLY commands in order to avoid total 
system collapse. 

Flowchart D-l-F in this section shows how to dump low address storage by using the 
ALTER/DISPLAY feature on the console printer. Flowcharts in Section 3 indicate 
when to dump low address storage. 

CAW (Channel Address Word) 

The CAW specifies the storage protection key and the address of the first channel 
command word associated with the START I/O instruction. The CAW is found at 
hex location 48. 




KEY 


0000 


Channel Command Word Address 



31 



Note: After the execution of any dump program, the information in the CA W is 
unreliable. In this case, the start address of the CCW is found in the command 
control block (CCB). 

Locating CCBs is described in Section 4. 
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CSW (Channel Status Word) 

The CSW informs the program of the status of an I/O device or the conditions 
under which an I/O operation has been terminated. The CSW is formed, or parts 
of it are replaced, during I/O interruptions and during execution of I/O 
instructions. The CSW is placed in low address storage at location hex 40. It is 
available to the program at this location until the next I/O interruption occurs or 
until another I/O instruction generates a new CSW, whichever occurs first. When 
the CSW is stored as a result of a START I/O instruction, the I/O device is 
identified by the I/O address in the old PSW. The information placed in the CSW 
by an I/O instruction pertains to the device addressed by the instruction. 

The CSW format is shown below. 



t 



Key 





L 


J 
CC 

1 


Channel Command Address 


Unit Status 


Channel Status 


Count ]] 





4 






8 


32 


40 


48 63 



Bits 0- 3 


Protection key used in the last operation 


Bit 5 


Reserved 


Bits 6- 7 


Deferred condition code 


Bits 8-31 


Address plus 8 of the last CCW used 


Bits 32-39 


contain the unit status byte: 




Bit 32 attention 




Bit 33 status modifier 




Bit 34 — control unit end 




Bit 35 busy 




Bit 36 channel end 




Bit 37 — device end 




Bit 38 unit check 




Bit 39 — unit exception 


Bits 40-47 


contain the channel status byte: 




Bit 40 — program-controlled interruption 




Bit 41 incorrect length 




Bit 42 program check 




Bit 43 — protection check 




Bit 44 — channel data check 




Bit 45 channel control check 




Bit 46 — interface control check 




Bit 47 chaining check 


Bits 48-63 


Residual count of the last CCW used 






Note: After the execution of any dump program, the information in the CSW is 
unreliable. In this case, CSW information is found in the command control block 
(CCB). 

Locating CCBs is described in Section 4. 
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o 



PSW (Program Status Word) 

The PSW contains information required for the program execution. By storing the 
PSW, the control program can preserve the status of the CPU for later inspection. 
By loading a new PSW or part of a PSW, the status of the CPU can be changed. 

The format of old and new PSWs is the same as that of the current PSW, shown 
below : 



LOW ADDRESS 
STORAGE 



u 


R 


U 


U 





T 


1 


E 


Protection 
l<ey 


1 


iVI 


W 


P 


U 


U 


C 


C 


Program 
mask 


Unassigned 


Reserved 


^ Instruction Vi 
J) address JJ 



















8 










16 








20 


24 


33 


40 63 



U indicates the bit is unassigned. 

indicates the bit is set to zero. 

1 indicates the bit is set to one. 



PROGRAM EVENT RECORDING MASK 
(Bit 1 ). 


If ON, permits interruptions subject to the program-event cxantro! bits in control 
register 9. 


TRANSLATION MODE (Bit 5). 


If ON, invokes the dynamic address translation (DAT) services. 


I/O MASK (Bit 6). 


It ON, enables I/O interruptions subject to the channel mask bits in control 
register 2. 


EXTERNAL MASK (Bit 7). 


If ON, enables external interruptions subject to the corresponding external 
sub-class mask bits in control register 0. 


PROTECTION KEY (bits 8-11 ). 


Is compared with a storage key whenever a result is stored, or information is 
fetched from a protected location. 


EXTENDED CONTROL MODE INDICATOR 
(Bit 12). 


If ON, indicates that the supervisor operates in Extended Control (EC) model. 


MACHINE CHECK MASK (Bit 13). 


If ON, enables machine check interruptions resulting from system damage or 
instruction-processing damage; other machine check interruptions are enabled 
subject to the sub-class mask bits in control register 14. 


WAIT STATE (Bit 14). 


If ON, indicates that the CPU is in the Wait State. 


PROBLEM STATE (Bit 15). 


If ON, indicates that the CPU is in the Problem State; if OFF, the CPU is in the 
Supervisor State. 


CONDITION CODE (bits 18-19). 


Is set as the result of the execution of certain instructions. 


PROGRAM MASK (Bits 20-23) 


comprises: 

Fixed-Point Overflow Mask 

Decimal Overflow Mask 

Exponent Underflow Mask 

Significance Mask. 

A Mask bit ON enables an interruption when the specified exception occurs. 

The Significance Mask bit also determines the manner in which floating-point 

addition and subtraction are completed. 


INSTRUCTION ADDRESS (Bits 40-63). 


For all PSWs, the address is that of the next logical instruction. In addition, for 
the new PSWs the address points to the routine that handles the particular 
interrupt, and for the old PSWs it contains the return address in the 
calling routine. 
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Displacement 
in hexadecimal 


Description (all numbers referenced are in hexadecimal). 


0-7 


The field is used for the following two functions: 

Restart New PSW: The new PSW is fetched from locations 0-7 during the restart operation. 

IPL PSW: The first eight bytes read during the iPL initial read operation are stored at locations 0-7. The 

contents of these locations are used as the new PSW at the completion of the IPL operation. These locations 

may also be used for temporary storage at the initiation of the IPL operation. 


8-F 


The field is used for the following two functions: 

Restart Old PSW: The current PSW is stored as the old PSW at locations 8-F during the restart operation. 
IPL CCW1 : Bytes 8-F read during the IPL initial read operation are stored at locations 8-F. The contents of 
these locations are ordinarily used as the second CCW in an IPL CCW chain after completion of the IPL Initial 
read operation. 


10-17 


IPL CCW2: Bytes 10-17 read during the IPL initial read operation are stored at locations 10-17. The contents 
of these locations may be used as the third CCW of an IPL CCW chain after completion of the IPL initial read 
operation. After IPL bytes 14-17 contain the address of the background partition communication region. 
Thereafter they contain the address of the communication region for the active partition. (Communication 
regions are described in Section 4). 


18-3F 


Interruption Old PSWs: The current PSW is stored as the old PSW at locations 18-1 F, 20-27, 28-2F, 30-37, and 
38-3F during the external, supervisor-call, program, machine-check, and input/output interruptions, 
respectively. 


40-47 


CSW : The channel status word (CSW) is stored at locations 40-47 during an I/O interruption. It, or portions 
thereof, may be stored during the execution of START I/O, START I/O FAST RELEASE, TEST I/O, HALT 
I/O, or HALT DEVICE, in which case condition code 1 is set. 


48-4B 


CAW: The channel address word (CAW) is fetched from locations 48-4B during the execution of START I/O 
and START 1 10 F AST R E LEASE . 


4C-4F 


Save area for job duration measurement when the interval timer location is being used by the supervisor 
IT option routines. 


50-53 


Interval Timer: Locations 50-53 contain the interval timer. The timer is updated whenever the CPU is in the 
operation state. Depending on the resolution of the timer, the low-order locations may not be updated. 


54-57 


Contain the time of day. 


58-7 F 


Interruption New PSWs: The new PSW is fetched from locations 58-5F, 60-67, 68-6F, 70-77, and 78-7F 
during the external, supervisor-call, program, machine-check, and input/output interruptions, respectively. 


80-83 


The address of the system communication region, described in Section 4. 


84-87 


External-interrupt Code: During an external interruption in the EC mode, the interruption code is stored at 
locations 86-87 and zeros are stored at locations 84-85. 


88-8B 


SVC-lnterrupt Code: During a supervisor-call interruption in the EC mode, the instruction-length code is stored 
in bit positions 5 and 6 of location 89, and the interruption code is stored at locations 8A-8B, Zeros are stored 
at location 88 and in the remaining bit positions of 89. 


8C-8F 


Program Check Interrupt Code: During a program interruption in EC mode the instruction-length code is 
stored in bit positions 5 and 6 of location 8D, and the interruption code is stored at locations 8E-8F. Zeros 
are stored at location 8Cand in the remaining bit positions of 8D. 


90-93 


Translation-Exception Address: During a program interruption due to a segment-translation exception or a 
page-translation exception, the translation-exception address is stored at locations 91 -93, and zeros are stored 
at location 90. 


94-95 


Monitor-Class Code: During a program interruption due to a monitor event, the monitor-class number is 
stored at location 95, and zeros are stored at 94. This field can be stored in either the BC or EC mode. 


96-97 


PER-lnterrupt Code: During a program interruption due to a program event, the program-event-recording 
(PER) code is stored at location 96, and zeros are stored at 97. This field can be stored only when the 
instruction causing the PER condition was executed under the control of a PSW specifying the EC mode. 


98-9 B 


PER Address: During a program interruption due to a program event, the program-event-recording (PER) 
address is stored at locations 99-9 B, and zeros are stored at location 98. 

This field can be stored only when the instruction causing the PER condition was executed under the control 
of a PSW specifying the EC mode. 


9C-9F 


Monitor Code: During a program interruption due to a monitor event, the monitor code is stored at locations 

9D-9F, and zeros are stored at location 9C. 

This field can be stored in either the BC or EC mode. 



Table E-2 Format and contents of low address storage. 
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These bytes may contain: 

• IPL error cxjdes during errors at IPL, or 

• coded nnessages if an error occurs during normal 
program execution, and SYSLOG and SYSLST 
are both inoperable, (see E-3 in this section). 



After IPL, these four bytes 
contain the address of the BG 
communications region. There- 
after, they contain the address of the 
communications region for the 
active partition. 



Key 


0000 


Channel Command Address 


Unit Status 


Channel Status 


Count 



FORMAT OF EC MODE PSW 


























U R U U T 


1 



E 


Protection 
key 


1 MWPUUCC 


Program 
mask 


Unassigned 


Reserved 


Instruction address 



IPLCCW1 



28 Program old PSW 




4C job duration 



30 Machine check old PSW 



50 Interval timer 54 Time of day 



70 Machine check new PSW 



SVC ac Program check __ Translation g. Monitor PER gg ppR „HHrP« 9C Monitor code 

interr upt co de I "^ interrupt code 1 ^" exception | ^^ class code ^^^ address yt. Monitor coae 



18 External old PSW 



38 Input/output old PSW 



58 External new PSW 



78 Input/output new PSW 



000000000000 ILC 



PROGRAM-INTERRUPTION 
CODE 



The format and contents of low address storage 



\ 




00000000 



MONITOR CODE 



00000000 



PER ADDRESS 



00000000 MONITOR-CLASS 



PER CODE 



00000000 



00000000 TRANSLATION-EXCEPTION ADDRESS 



GR 0-F 

FP REG 

CR 0-F 

COMREG 



000000 
000020 
000040 
000060 

<rtroo8o" 

OOOOAO 

ooooco 

OOOAAO 



J, 0004C0 

dV fAj>004E0 

(Sr 000500 

CA'^ n00520i 
00 ^540; 
000560 
000580 



DEBUGEX3 

000000 IB 
00000000 

ooooooon 

004000FF 
OOOOFFFF 
BG AiJOR IS 0004A0 



12/06/73 

00040910 00000049 00000002 OOC0002E 00000000 

00000000 OOCOOOOO 4004007A 0004107A D7C8C1E2 

00000000 COOOOOOO 00000000 00000000 00000000 

0O0OE640 FFFFFFFF FFFFFFFF COOOOOOO OOOCOOOO 

OOOCOOOO 00000000 00000000 COOOOOOO 00000000 



21.01.45 



PAGE 



OOOOOOOC 00000000 
A00406EE 000422A0 
00000000 OOCOOOOO 
OOOCOOOO 00000000 
C2000000 OOG00200 



fOOOOOOOO 
f070D0000 



ooooooooTo C 

000085OE 



/^t^y'^ts^K' 



.cjUiU <^ /"SW 



0000E768 08000000 



04OCO0O0 00000902 




OOOOOBCC 
00000080 
OOCOOOOO 



0000E75a 
OOOCOOOO 
00020007 
20O0O060 



COOOOOOO OOCOOOOO 
OOCOOOOO 
FBCC1900 
04080000 
12042003 
OOOOCOuO 




^ac^^c^n,^ 



OOOCOOOO 
0000A50C 

ooB^ooo 
ooon»2Co 



DOO0( P4AQ , 
00000000 
045661E8 
0000D13A 
00020000 
00000100 



T)71D2000 00040004 
07OC2000 0000090C 
O4OCO00C 00000C14 

040c0000 ooooobio 
0000 0000 oooooicc 
oooc^oqeJU)ooooooo 



0000000 
F1F261F0 
00060FFF 
41044296 

46 300000 
COOOOOOO 
r00006l40 
00017000 
60800800 



— SAME — 
F661F7F3 
0004232F 
42974389 
3DCC3E4C 
04A010EO 
00002ECA 
C50C5DE6 
000008FC 



70007000 
C004232F 
3FC03F06 
3EBC0010 
00000588 
080407CO 
0032002C 
00009260 



0000( ^WO'^^^^tJ^^ 



Ej jfpOOO.O( 






•••••»•• 



• •••••• 4 






0000{ 



00000010 00003090 '^' 

C0C00340 40404040 

00004134 00C026C4 

00650000 0000700C 

00005F78 00006068 



000 C4C5C2E4 T/O Dtntt^JL^^ 

ED3 38AOCEDO 0C2E40FD 

4F0 00003CD4 00C0003C 

00007118 00003864 3BD45A30 

40404000 40404040 40404000 »••.. 

00004988 00005854 000082E8 •,/ • 

00000000 00008299 0000608B 

000060CO 00100010 000074BO -.,.. 



0EBUGEX3 

L 

20673340...M.... 
M.. 



(£nSffcr\ 



An example of a system dump printout, reduced in size, showing the address storage 
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Bytes - 3 of low address storage are used to store and record coded messages 
when a system malfunction occurs during IPL. Other occasions when coded 
messages are stored in these bytes are described below under "Wait states during 
problem program execution." 

Whenever a wait state occurs, it is imperative that these low address storage bytes 
are dumped by using the console printer ALTER/DISPLAY feature, described in 
D-1 of this section. 

The table below lists all the coded wait state messages: 



'■■'V..^' 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable nnachine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, l,S(1> 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, l,S{1) 


Not used 


Channel failure; channel address invalid. 


X'DI ' 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' Channel 


Unit or 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 








X'OO' 


Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO' (3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folic 


wing Hard Wait Codes are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


-Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


^MAINDR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes placed in low address storage. 


X'08' to 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



Notes: 1. A (X'C1'} = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S(X'E2') = Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table E-3 Wait State codes 
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Wait states during IPL 

If the system enters the wait state during an IPL procedure and no message is 
printed on SYSLXDG, the operator should record at least the first five bytes of low 
address storage. The IPL error message number and action code are displayed in 
hex in these bytes. For example: 

Message Oil 1 A appears in low address storage bytes 0-4 as 

F0C9F1F1C1 

The operator should look up this message in DOS /VS Messages and perform the 
indicated action, except for the messages noted below. 



Other Aids 

WAIT STATE 
MESSAGES 






O 



/PL error messages 

If there is an equipment malfunction during IPL, or the IPL cannot be loaded, an 
IPL error message is placed in bytes 0-3. In this state all interrupts are disabled, 
and you must repeat IPL after dumping low address storage, as shown in 
flowchart D-l-F in this section. 



ByteO 


Byte 1 


Byte 2 


Byte 3 


Meanings: 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL Input/output error: 

• I/O error on SYSRES 

• I/O error on communication device (see notes 1 and message X'F0C9F0F1' 
below) 

• Equipment malfunction during the STORE CHANNEL ID instruction 
(see note 3) 

• Supervisor entry not found. 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 1 6K of real storage is left for problem 
programs. Check that the correct disk volume is mounted on the device 
assigned to SYSRES and re-IPL. If the error recurs, the system programmer 
must check the allocations of real partitions specified in the supervisor to 
be used, and check that at least 16K of real storage is available for execu- 
tion of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FI' 


If a card reader has been assigned to SYSRDR during system generation 
and is to be the IPL communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation 
and yet it is to be the IPL communication device, simply READY the 
reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested can not be found. 
Check that the correct disk volume is mounted on the device assigned to 
SYSRES. If it is correct, re-IPL and specify a different supervisor when 
message 0I03A is issued and press the END/ENTER key, or press END/ 
ENTER key only, to load the standard supervisor. (If possible contact 
the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FV- 
X'F2' 


X'FO'- 
X'F8' 


Refer to messages 01 100A - 0128A in DOS/VS Messages in the 
DOS/VS Messages manual 




Note 1: When the IPL procedure reaches the normal IPL wait state, and the IPL 
communication device is to be SYSLOG, press the REQUEST key on 
the console printer keyboard. 

Note 2: When byte = X'OO', byte 2 indicates the channel for which the STIDC 
instruction was issued. 
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Wait states during program execution 

Three conditions will place a coded message in low address storage during program 
execution: 

• I/O device error 

• Hardware failures 

• Unrecoverable I/O error during FETCH. 

1 . I/O device error messages. 

Device Error Recovery Messages. 

The example below shows the information that is placed in low address storage 

bytes hex 0-3 when a wait state is caused by an I/O device error, and both 

SYSLOG and SYSLST are inoperative, or SYSLOG is not assigned. 

An example of a coded device error recovery message as it is stored in the low 

address storage is shown below: 

0P08A interv'reqsyslst=ooe 

An example of a device error recovery message is shown below: 




Refer to OP messages in DOS/VS Messages, 



ByteO 


Byte 1 


Byte 2 


Byte 3 


X'08' to 
X'60' 


Action 
indicator 
'CI ' - 'C4' 


Channel 


Unit 



^ J 



If this condition occurs, the operator must dump, or display and note, bytes 0-3 
of low address storage, and inspect the contents of byte 0. This byte contains a 
hex number that corresponds to an OP message Usted in DOS/VS Messages. 

Before proceeding with system operation, the operator will have to decide whether 
to continue system operations with the program currently running or to CANCEL 
all jobs and repeat IPL. This decision depends on system commitments and the 
importance of other programs that are running. 

To continue operations, the operator must first inspect the contents of byte 1 
for the presence of a hex CI or C4. The flowchart opposite shows what further 
actions can be taken under these conditions, and a flowchart in Section 3 indicates 
to operators when this procedure may be required. 



^IL,.„.„J^ 
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From Chart 03 
Section 3. 
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o 



Byte 1 contains X'CV 



Byte 1 contains X'C4' 



Inspect bytes 2 and 3 
Byte 2 indicates the channel, 
byte 3 indicates the unit. 



^'^\ 

^t^"^ 



Insert X'OV (RETRY) 
in byte 4, and press the 
INTERRUPT key 



E 3-F 



Yes 



Either; 

Perform any manual recovery procedures 

implied by the error conditions, 

(Refer to component description and operating 

procedures manual for the device.) 

Ready the device. No response is necessary, 
or 

Cancel all jobs by inserting X'03' in byte 4, 

and press the INTERRUPT key. 




Either; 
Insert X'02' (IGNORE) 
in byte 4, 

or 

Insert X'03' (CANCEL) 
in byte 4, and press the 
INTERRUPT key 



System operation 
continues 



Operator procedure to recover from an input/output device error, when the device 
error recovery message cannot be printed on either SYSLOG or SYSLST. 
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2. Hardware failure 

If a hardware failure occurs that cannot be corrected by the RAS transients 
(R-transients), a message is normally printed on SYS LOG. If this is not 
possible a coded message is placed in low address storage. 



A complete list of wait state messages is given in table E-3. 



3. Unrecoverable I/O error during FETCH 

If an unrecoverable I/O error occurs during a FETCH operation, a coded message is 
placed in the low address storage bytes 0-3. 

The contents of the following 24 bytes starting at byte 4 will contain device sense 
information. 

(The number of sense bytes is device-dependent). 

The sense data is useful to your IBM customer engineer and may also be of use 

to your system programmer. The component manual for the failing device provides 

details about the cause of failure. Before repeating IPL, try a different drive. 



X. ,^ 
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A linkage editor map is an aid to program debugging. This map is obtained during 
link-editing when SYSLST is assigned (unless ACTION NOMAP was specified). 
Details about link -editing are found in DOS/VS System Control Statements. 



Description 

When used in conjunction with a storage dump and program listings, the linkage 
editor map will help in locating programs and subroutines that are included in the 
programs at object time. Common areas, load address, relocation factors, low and 
high addresses are also shown. In addition, the PHASE card is displayed to show 
where the phase was loaded, which is also helpful when working with multi- 
phase programs. 

The linkage editor map also shows where programs should be located in virtual 
storage, where overlays are loaded, and whether the program is relocatable, self- 
relocating, non- relocatable or SVA-eligible. The example below shows a hnkage 
editor map. 
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12/06/73 PHASE 


XFR-AD 


LOCORE 


HICORE 


OSK-AD 


ESQ TYPE 


LABEL 


LOADED 


REL-FR 




I 




• PHASE*** 


040078 


040078 


04232F 


047 13 3 


CSECT 

CSECT 

* ENTRY 

CSECT 

CSECT 

* ENTRY 

CSECT 


BEGIN 

IJFFZ2HZ 
IJFF2ZZZ 

IJCFZIZO 

IJDFCZZZ 
IJOFZZZZ 

IJ2L0057 


040078 

041E08 
041ED8 

042230 

0422A0 
0422A0 

0422F8 


03C878 RELOCATABLE 
041 ED8 

042230 
0422A0 

0422F8 


^ (jTv ^0 /tr) 
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The next two illustrations show an example of the DIAGNOSTIC OF INPUT, 
and virtual storage MAP, which are printed on SYSLST during link-editing. 

The example contains errors which are discussed in the text following each figure. 



How to use 

Refer to A-2 in this section for an example that shows how the map is used during 
debugging in conjunction with a system dump and program listing. Examples at 
the end of this chapter show the information reports that immediately follow the 
map. These reports confirm that the new phase, or phases, are correctly cataloged, 
and enable you to monitor the status of your libraries. 
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JOB 

ACTION 

LIST 

LIST 

21411 

LIST 
LIST 

21411 

LIST 
LIST 

21411 

LIST 

21311 

LIST 

LIST 
LIST 



EXAMPLE 



DISK LINKAGE EDITOR DIAGNOSTIC OF INPUT 



TAKEN MAP CLEAR 

PHASE PHASE1,R0CT,NOAUTO 
INCLUDE ,(NAMEONE) 

EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000003 NAMETWO 2 FF0130 OOOOCA NAMTHREE 000200 0000A8 

PHASE PHASE2,x,N0AUT0 
INCLUDE .(NAMEFOUR) 

EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000003 NAMETWO 2 FF0130 OOOOCA NAMTHREE 000200 0000A8 

PHASE PHASE3,PHASE1+73,NOAUTO 
INCLUDE ,(NAMETWO,NAMTHREE) 

EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000007 NAMETWO 000130 001898 NAMTHREE 000200 0000A8 

INCLUDE RELMOD 

INCLUDE RELMOD 

EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000003 NAMETWO 000130 001928 NAMTHREE 000200 0000A8 

PHASE PHASE4,+16500 
INCLUDE RELMODUL 



21441 REL 0015 TXT 00425C 0038 F0F1 1A361A56 46D0E254 4130EF1E D500EF1E E5FA477C E2869201 EF1E0630 9509EF1D 4770E286 

LIST AUTOLINK AUT0M0D2 

LIST PHASE PHASE5,+X'25BA',NOAUTO 

LIST REP 0C4018 0034130,C03A,47F0,C30E PATCH ASSEMBLY ERRORS 

LIST REP 0C40CC 003D20E, 

21021 REP 0040C0 C3F0 0003 D20EF0C5 6B404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 

LIST ENTRY INVALID TRANSFER LABEL 



^^uJ^ 



Line 1 (ACTION TAKEN). MAP and CLEAR have been specified on separate ACTION cards. Had NOAUTO been specified, it would 
also appear on this line. 



Lines 4, 7, 10, and 1 3. Error 2141 1 (duplicated ESID number) is printed four times because the submodular structure of the phase 
demanded four passes over the same module. As the linkage editor processes in its own input area, the record printed may not be 
identical to the original input record. Lines 10 and 1 3 differ in content from lines 4 and 7 for this reason. 



Lines 11 and 12. Line 11 is printed when the statement is read by the linkage editor. Line 12, error 2131 1 indicating that the 
requested module is not in the relocatable library, is printed after the error is detected. 



Line 16. This is an example of an error detected in a TXT statement. Error 21441 indicates that the ESID number F0F1 is invalid. (It 
should be binary 01.) 



Line 17. Indicates the AUTOLINK feature was used for relocatable library module inclusion in the phase named above it. 



Line 19. An example of a valid REP statement. 



Lines 20 and 21. An example of an invalid REP statement. Line 20 is printed when the statement is read by the linkage editor. 
Line 21, error 21021 indicating an invalid operand in the statement, is printed after the error is detected. 



When a module is included from the relocatable library, it is not possible to guarantee that the sequence identification printed in 
columns 8- 1 5 is that of the record printed. This occurs because the MAINT librarian program reblocks the content of the cards to a 
more compressed format. 
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PHASE 


XFR-AD LOCORE 


HICORE DSK-AD 


ESD TYPE 


LABEL 


LOADED 


REL-FR 


^ ^ 


2 


COMMON 






COM 




001800 


0000C8 




3 


ROOT PHASE1 


0018C8 0018C8 


0019F7 013 2 2 


CSECT 


NAMEONE 


001 8C8 


0C18C8 


NOT RELOCATABLE 


4 








ENTRY 


P0INT1 


0018CC 






5 








X ENTRY 


POINT2 


001930 






6 


PHASE 2 


0019F8 0019F8 


001A87 013 3 1 


CSECT 


NAME FOUR 


001 9F8 


0C1750 


NOT RELOCATABLE 


7 


OVEROOT PHASE 3 


0019E8 001918 


001 B1F 013 3 2 


CSECT 


NAMETWO 


001918 


0017E8 


NOT RELOCATABLE 


8 








CSECT 


NAMTHREE 


0019E8 


0C17E8 




9 








X ENTRY 


P0INT3 


001 A2C 






10 








CSECT 


NAMEFOUR 


001 A90 


0C17E8 




11 


PHASE4 


0043A0 004140 


0059A3 013 4 1 


CSECT 


AUT0M0D1 


004140 


003A98 


NOT RELOCATABLE 


12 








ENTRY 


AUTOENT 


0042D0 






13 








CSECT 




0043A8 


0C3EF8 




14 








CSECT 


AUT0M0D2 


0043C0 


0003C0 




15 


PHASES 


002688 002688 


002767 013 6 1 


CSECT 




002688 


-001 B08 


NOT RELOCATABLE 


16 








CSECT 


NAMES 


002688 


-001 BOS 




17 


•UNREFERENCED SYMBOLS 




EXTRN 


POINT2 








18 








EXTRN 


P0INT4 








19 


ROOT STRUCTURE OVERLAID BY SUCCEEDING PHASE 












20 


POSSIBLE INVALID ENTRY POINT DUPLICATION IN INPUT 












21 


INVALID TRANSFER LABEL ON END OR ENTRY STATEMENT IGNORED 










22 


CONTROL SECTIONS OF ZERO LENGTH IN INPUT 












23 


002 UNRESOLVED ADDRESS CONSTANTS 














24 


003 ADDRESS CONSTANTS OUTSIDE LIMITS OF PHASE 














o 



2 (COMMON). The entry under REL-FR contains the length instead of the relocation factor in the case of ESD-type COMMON. 



Line 



Lines 5 and 9 (referring to UNREFERENCED SYMBOLS). These ENTRY labels (POINT2and POINTS) are not referenced as 
external symbols, that is, by corresponding EXTRN statements. 



Line 17 and 18. These labels indicate EXTRN references that cannot be matched with a corresponding entry point. In such a case 
*ENTRY ESD-types may be the corresponding, but misspelled, point. In the submodular structure, CSECTs not specified in any 
namelist appear as EXTRNs. The labels can also indicate unreferenced EXTRNs. 



Line 3, 6, 7, 1 1 , and 1 5. All phase origins (entries under LOCORE) are incremented by the length of COMMON. 



Line 19. Warning message. When this message appears, OVEROOT is printed to the left of the name of the phase (PHASES) that 
overlays the ROOT phase. 



Line 20. Warning message. An entry label appeared at leiast twice in the input stream. At its second (or later) appearance, it was not 
possible to validate it as being a true duplication. The most common reason for this message is submodular structure with (source) 
ENTRY labels defined before the CSECT in which the entry point appears. 



Line 21. An overriding transfer label in the ENTRY statement was not defined within the first phase, or a transfer label was not 
defined in an END statement in its module. 



Line 24. Address constants had load addresses outside the limits of the phase in which they occurred. This usually occurs if the 
control section length is incorrectly defined in the input. 



Line 22. Warning message. The COBOL, FORTRAN, RPG,and PL/I (D) compilers do not supply all of the information required 
by the linkage editor in the ESD records. Specifically, the control section length is provided in the END record. If a control section 
defined in the ESD information has a length of zero, it normally indicates that the length is to appear in the END record. It is 
possible to generate zero-length control sections through assembler. Such a condition produces this message. This is not an invalid 
condition if it is not the last control section that is of zero length. If the last control section is of zero length, the length is implied 
to be in the END record and, if not present, causes an error condition. 



Line 23. These address constants correspond to the EXTRNs shown in line 1 7 and 1 8. 
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SYSTEH DIRECTORY— SYSRES 


CORE- 


-IMAGE 


RELOCATABLE 


SOURCE-STATEMENT 


PROCEDURE 




* 12/06/73 

^ DIRECTORY 

DIRECTORY 

. DIRECTORY 
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STARTING ADDRESS 
NEXT ENTRY 
LAST ENTRY 


C 
00 
00 
00 


H 
10 
11 
14 


R 
01 
IS 
15 


E 

15 
17 


C H R E 
16 00 01 
16 01 07 02 
16 04 17 19 


C 
31 
31 
31 


H 
00 
00 
04 


R 
01 
08 
27 


E 

03 
09 


C 
41 
41 
41 


H 
00 
00 
04 


R E 
01 

03 04 
27 09 




LIBRARY 
. LIBRARY 
' LIBRARY 


STARTING ADDRESS 
NEXT AVAILABLE ENTRY 
LAST AVAILABLE ENTRY 


00 
13 
15 


15 
13 
19 


01 
02 
04 




16 
27 
30 


05 01 
04 05 
19 16 


31 

38 
40 


05 
14 
19 


01 
05 
27 




41 
41 
45 


05 
09 
19 


01 
22 

40 




DIRECTORY 


ENTRIES ACTIVE 


537 








457 




68 








19 








LIBRARY 
LIBRARY 
LIBRARY 
LIBRARY 


BLOCKS ALLOCATED 
BLOCKS ACTIVE 
BLOCKS DELETED 
BLOCKS AVAILABLE 


1220 

1033 

00 

187 








4720 

35 08 

00 

1212 




5265 

4027 

00 

1238 








3795 

176 

00 

3619 








AUTOMATIC 


CONDENSE LIMIT 


00 








00 




00 








00 








LIBRARY 
DIRECTORY 


ALLOCATED CYLINDERS 
ALLOCATED TRACKS 


15 
05 








15 

05 




10 
05 








05 
05 
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An example of the SYSTEM DIRECTORY status information printout that 
immediately follows the MAP, after cataloging a phase to the system core image 
library on SYSRES. 
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i PRIVATE DIRECTORY 
^ j 12/06/73 


IHiHH 














PRV-CORE IMAGE 


PRV-RELOCATABLE 


PRV-SOURCE STATEMENT 






















3. 


^ DIRECTORY STARTING ADDRESS 

1 DIRECTORY NEXT ENTRY 
1 DIRECTORY LAST ENTRY 


C H R E 
47 10 01 
47 12 06 07 
47 14 15 17 


C H R E 
73 00 01 
73 02 09 13 
73 09 17 19 


C H R E 
103 00 01 
103 01 15 07 
103 09 27 09 










LIBRARY STARTING ADDRESS 
k LIBRARY NEXT AVAILABLE ENTRY 
' LIBRARY LAST AVAILABLE ENTRY 


47 15 01 

71 09 01 

72 19 04 


73 10 01 

98 04 06 

102 19 16 


103 10 01 
196 05 02 
196 19 27 














-—STATUS INFORMATION— 












DIRECTORY ENTRIES ACTIVE 


631 


848 


412 










• LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 
J LIBRARY BLOCKS DELETED 
' LIBRARY BLOCKS AVAILABLE 


2020 

1812 

84 

124 


9440 

7909 

00 

1531 


50490 

50086 

00 

404 










1 AUTOMATIC CONDENSE LIMIT 


00 


00 


00 










i LIBRARY ALLOCATED CYLINDERS 
1 DIRECTORY ALLOCATED TRACKS 


26 

05 


30 
10 


94 
10 


(rxizyev^) 






1 
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An example of the PRIVATE DIRECTORY status information printout that 
immediately follows the MAP after cataloging a phase to the private core image 
library. SYSTEM DIRECTORY status information, shown above is printed 
following this report. 

Note: The format of this printout depends on whether SYSCLB, SYSRLB, and 
SYSSLB were assigned before the linkage editor run. 
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Summary THE LINKAGE 

EDITOR MAP 

The following list summarises the information contained in the map. 

1. The name of each phase, the lowest and highest virtual storage locations of 
each phase, and an indication if the phase is relocatable, non-relocatable, 
self-relocating or SVA-eligible. It also shows the disk address in hex where the 
phase begins in the core image library. 

2. An indication if the phase is a ROOT phase, or if a phase overlays the ROOT 
phase in any way (designated by OVERROOT). 

3. The length of COMMON, if appropriate. 

4. The names of all CSECTs belonging to a phase, the address where each CSECT 
is loaded, and the relocation factor of each CSECT. 

5. All defined entry points within a CSECT. If an entry point is unreferenced, it 
is flagged with an asterisk (*). 

6. The names of all external references that are unresolved. 

7. The transfer (execute) address of each phase. 

8. Warning messages are printed if: 

• The ROOT phase has been overlaid. 

• A possible invalid entry point duplication occurred. 

• The ENTRY or END statement contained an invalid (undefined) 
transfer label. 

• At least one control section had a length of zero. 

• The assembled origin on an RLD statement was outside the limits of 
the phase. 

• An address constant could not be resolved. 

These messages may or may not indicate actual programming errors. If NOMAP 
is operational, the warning messages are not printed. 
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Hardware Error Recording and Recovery 



RMS 



General Description of RMS 

The need for the IBM serviceability aids that are collectively termed RMS (Recovery 
Management Support) has been described in Section 1 under the heading 
"Hardware Failures." 

RMS consists of software routines that are grouped according to their function: 

• MCAR (Machine Check Analysis and Recovery) 

• CCH (Channel Check Handler) 

• ERP (I/O device Error Recovery Procedures) 

• RMSR (Recovery Management Support Recorder). 

Each function listed above is considered to be a function of RMS, and if required, 
must be included in your supervisor during system generation. The function RMSR 
consists of several recording facilities: 

Unit check recording 

Machine check and channel check recording 

Tape/disk error statistics by volume 

MDR (Miscellaneous Data Recorder) 

IPL information 1 Reliability Data 

End of Day recording for devices and for the system, j Extractor (RDE) 

RMS is always supported on the Models 135, 145, 155-11 and 158, and the RMSR 
facilities supported depends on the parameters specified during system generation. 
The parameters of the supervisor macros affecting the subjects described in this 
section are discussed here but further details required for generating a supervisor 
are found in the DOS/VS System Generation manual. 

System Requirements 

In order to perform its functions, RMS uses two logout areas contained in real 

storage: 

• The fixed logout area 

• The model-dependent log out area (not applicable to Models 1 15 and 125). 
As the name "model-dependent logout area" implies, the real storage area reserved 
for the logout areas varies for different System/370 Model types. Therefore, if 
you know during supervisor generation that the supervisor will be used on a larger 
model, specify the larger model in the MODEL = parameter of the CONFG super- 
visor generation macro. 

Because the Models 115 and 125 employ both software and hardware recording 
functions a more detailed description on these Models is given in the following 
paragraphs. For the Model 125, a hardware function records CPU and channel hard- 
ware failures on the DISKETTE. This also appHes to hardware failures of natively 
attached I/O devices. Device ERP is always supported for all models. When the 
Models 115 and 125 support channel attached I/O devices, or magnetic tape units, 
or teleprocessing, RMSR support must be generated during system generation. 
(RMSR support records until checks on SYSREC.) RMSR support can be generated 
by either the parameter CHAN=YES, or RMS=YES, in the SUPVR system 
generation macros. 

When RMS=YES: hardware failures that occur on all attached 1/0 devices are 
recorded on SYSREC by the RMSR software routines. However no error recording 
occurs for the Multifunction Card Machine (MFCM) if attached. Simultaneously the 
failures that occur on natively attached devices are also recorded on the DISKETTE 
by a hardware function. In the latter case of RMS=YES, MCAR/CCH records are 
recorded on SYSREC as well as on the DISKETTE, and the RDE facility is also 
supported. 

When RIV1S=N0 and CHAN-YES: the supervisor generated supports RMSR for 
channel attached devices, tape units, TP and MCH/CCH. Therefore hardware 
failures that occur on these devices are recorded on SYSREC by the software 
routines as well as being recorded on DISKETTE by the hardware recording 
function. In this case however RDE is not supported. 

When RIVIS=N0, CHAN=N0 and MCH=N0: no recording occurs on SYSREC and 
a hard wait is entered on the occurrence of a hardware failure 
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Legend 



■*" Data flow 

•*- Manual control 



Operator communications 



Notes: 

7. Not applicable to Models 1 15 and 125. 

2. Not applicable to Models 115 and 125. 
that does not support the RMSR 
function. 

3. Use the U hardware command 
for a Model 1 15 and 125 that 

does not support the RMSR function. 
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RMS 



Hardware errors 



CPU errors 



Hardware instruction retry 
(HIR). Error checking and 
correction (ECC) 



Channel, control unit or 
device errors 



Use the MODE command to: 

• Set HIR or ECC to recording or 
quiet mode. (See note 1 ) 

• Change the error frequency limit, 
(EFL) threshold values for HIR 
and ECC. (See note 1) 

• Inquire about the status of 
present recording mode. (See 
note 1) 

• Set the recording mode for tape 
error statistics (TES) recording. 
(See note 2) 

• Change type of recording for 
a specific device. (See note 2) 





Machine check 
and 

input/output 
interrupts 



Hardware control 



Software control 



Messages printed on SYS LOG or 
displayed on DOC inform operator 
of a hardware failure. 



DISKETTE 




Error 
Data 



Recovery Management Support (RMS) 

• Check severity of the error 

• Attempt recovery from the error 

• Record the error on SYSREC 

• Print informative messages on SYSLOG. 



Issue ROD command at 
system switch-off, or at end of 
shift, or end of day. (See note 3). 
IPL reason information 
(See note 2) 



Messages on SYSLOG inform 
operator about status of 
SYSREC, (Full, overflow, etc.) 



System 
recorder 

file. 
SYSREC 



EXEC EREP. Initiated by job 
control statement. 



Select System/370 EREP options 
by control statements. 



f 

i 

I- 



No recording on SYSREC 
occurs on Models 1 15 and 
125 when RMS = NO 



System/370 EREP 



«•- System/370 EREP options. 
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RMS Operation 



An understanding of the purpose and operation of RMS will help when 
interpreting the EREP printout and the System/370 Models 115 and 125 
Maintenance Log Analysis Feature. 

The following four figures show the relationship between the hardware and 
software recording faciUties, and show the connection between the DISKETTE 
(Models 1 15 and 125 only), the SYSREC file, and the EREP options. 

Figure F-l-A shows the types of machine checks generated and the real storage 
used for the logout areas. Error information is first logged in this area before being 
used by the RMS software routines. On the System/370 Models 1 15 and 125, 
the logout area is replaced by the DISKETTE recording file. 

Figure F-l-B describes the division of machine check interrupts into soft machine 
checks and Figure F-l-C illustrates the general flow of processing after a hard 
machine check occurs. 

Figure F-l-D expands the RMS routines into: 

• MCAR 

• CCH 

• Channel check ERPs that are initiated by CCH routines for device-dependent, 
channel error recovery. 

• Unit check ERPs that handle the unit check conditions of the devices. 

This figure also shows how the errors are first checked for their severity, and shows 
how the effect on system operation depends on the type and severity of the error. 

Figure F-l-E shows the types of records that are recorded on SYSREC. 

Figure F-l-F represents the EREP options that can be selected by the operator. 
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RMS 



Main storage or control storage 
(ECO failures 



Input/output 
channel or 
control unit 
device failures 



Storage 




Storage 




Key in 


error 




error 




storage 


corrected 




uncorrected 




uncorrected 



CD 
Time of 
day clock 
damage 



TD 
Timer 
damage 



PD 
Instruction 
processing 
damage 



SR 
System 
recovery 



ED 
External 
damage 



SD 
System 
damage 
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Machine check interrupts 





I/O interrupts 



Hard machine check interrupts 



Soft machine check interrupts 



For the Models 115, 125 
and 1 58 log out areas 
are replaced by the 
DISKETTE 



PSWs, CSW, CAW 
timer 



I/O communications 
area 



Fixed logout 
area 



CPU extended 
logout area 



Extended channel 
logout area 



Figure F-1-A illustrates how data about a hardware error is logged in 
fixed areas of real storage, or on the DISKETTE. 
This data is used by soft ware routines for error recovery (where 
possible), and for recording the data on SYSREC. 
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Successful 

CPU retry 

HIR 

(Not applicable to 

Models 115 and 125) 



Soft Machine Check Interrupts 



ECC single-bit inter- 
mittent processor 
storage correction 
(if enabled by 
operator) 

1 



For a Model 1 15 or 125 that does not 
support the software MCAR/CCH, a 
coded message is placed in general 
register ll(X'B') and low address 
storage and system operation is 
terminated. 



I 



External Damage 
(Not applicable to 
Models 1 15 and 125) 



Log status and 
record report 
on SYSREC 



Inform operator 
of action; 
continue processing 



Interval 

timer 

damage 



Time of Day 
Clock damage 



Only applicable 
to the Models 
115 and 125 
if RMS=YES 
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Figure F-l-B. General flow of DOS/VS MCAR processing after soft machine check interrupts 

Hard Machine Check interrupts 
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or unretryable 
CPU error 
associated 
with control 
program 




Multiple-bit 
processor storage 
error in 
processing program 
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processing 
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control 
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Storage protect 
key failure 






































External Damage 
(Applicable to 
Models 1 15 and 
125 only) 








i 
















Attempt 
repair 
procedure 
and continue 






Log status and 
record data 
on SYSREC 
































Attempt 
logging and 
recording 
of status 


















Attempt 
logging and 
recording 






















1 






Determine 
task affected ; 
log status and 
record on 
SYSREC 






Inform operator 
and terminate 
system operations 














1 










Validate 
the error 




Inform operator 
and terminate 
system operations 




Hard Wait 


1 










^k 




Diagnostic 

procedures 

(EREP) 

IBM customer 

engineer test 














^j/^ Error ^^ 

^v validated ^/"^ 






Log status and 
record results 
on SYSREC 
and inform 
operator 






^\ ^ 


^ 1 














DRAP 
Dynamic 
Re-allocation 
of Partitor 
or page pool 




Hard Wait 
























Terminate 
affected task and 
inform operator 










1 












HARD WAIT 






DIAGNOSTIC 






1 






1 






Procedi 

EREP 

SEREP 


jres 












Continue 

system 

operation 




— 


Cancel task 
and continue 
system operation 








Figure F-l-C. General flow of DOS/VS MCAR processing after hard machine check interrupts 



2.192 Serviceability Aids. 



Hardware errors 



Hardware Error Recording and Recovery 

RMS 



I Not applicable to Models 1 1 5 and 1 25 I 



I/O Channel 
errors 



I/O control 
unit or 
device errors 



CPU 
errors 



Main storage or 
control storage 
errors 



HIR 



ECC 



Automatic retry and correction 
procedures by hardware 



Generate I/O 
interrupt 



J Generate machine 
check interrupt 





Automatic System Action 



■zzrz I 



• Save data about 
the error in register 

• continue processing 
in a degraded mode 



Software routines 



I/O control 
unit or device 
errors 



I/O 

channel 

errors 



CPU 

instruction 
errors 



Main storage or 
control storage 
errors 



MCAR 
CCH 
ERP 
RMSR 



TES 



Accumulate 
Device status 
Data in PUB2 



Record PUB2 
counter infor- 
mation for device 
onSYSREC, if 
counter overflow 
or IPL/EODor 
ROD command 




Machine Check Analysis Recovery 
Channel check Handler 
Device Error Recovery Procedures 
Recovery Management Support Recorder 
(For Models 115 and 125, RMSR is only 
required for channel attached devices, 
TP, and tape units. For natively attached 
devices, recording is via hardware) 
Tape Error Statistics. 

Automatic System Action 



Attempt to record data about 
the error on SYSREC 



• Attempt to print a message 
on SYSLOG 

• Place system in hard wait 



Yes 



Yes 



Record data about the error 
on SYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing 
with next job 




Record data about the error 
onSYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing with 
next job 



Record data about the error 
on SYSREC 



• Print message on SYSLOG 

• Continue processing the job 



Figure F-1-D Illustrates the connection between hardware error detection 
and software routines that enable data about the error to be recorded. It 
also shows the system action taken, depending on the type of error. 
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Figure F-l-E Input records to SYSREC. 
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Figure F-l-F Output from SYSREC. 

(Selected by EREP options.) 
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Components 

The software routines required to support the RMS options are: 
Resident MCH 
Resident CCH 
Resident RAS monitor 
Resident DASD ERP 
Device ERP transients (A transients) 
MCH/CCH transients (R transients) 
RMSR transients (A and R transients). 

To record tape and disk error statistics by volume, the option RMSR also uses 
some B transients. A job control module is required to enable RMSR to record 
IPL/EOD data. 

The figures below shows the relative locations, in the real address area, of the 
RTA (RAS transient area), LTA (Logical transient area), and FT A (Physical 
transient area). 

Note: No error recording or recovery can be executed before IPL is successful. 
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Note: Not applicable to the 
Models 115 and 125 



Note: There is no need for 
software control or EFL for 
HIR on the Models 115 
and 125 



Detailed Description of RIVIS Functions 

Machine Check Analysis and Recovery (MCAR) 

Two hardware error recovery features, Hardware Instruction Retry (HIR) and 
Error Checking and Correction (ECC), perform hardware correction for machine 
malfunctions. RMSR interfaces with the error correction hardware through 
Machine Check Analysis and Recovery (MCAR). 

When the CPU is in the 'recording mode,' MCAR is informed when a machine 
malfunction occurs and is corrected by means of a 'soft' (or recovered) Machine 
Check Interrupt (MCI). When the CPU is in 'quiet mode' the hardware correction 
routines do not generate a soft MCI if the malfunction is corrected. If the hardware 
correction routines cannot correct the malfunction, a 'hard' (or unrecoverable) 
MCI is generated regardless of the mode setting. 

When a soft MCI occurs, RMSR writes a record in the recorder file containing 
identification information and the contents of the machine-independent logout 
area and the machine -dependent logout area (if available). The operator is 
notified that a soft MCI occurred, control is returned to the interrupted code, and 
system operation continues. 

Dynamic Reallocation of Partition or page pool (DRAP): When a hard MCI occurs, 
the MCAR routine attempts to isolate the failure to a partition in order to cancel 
the damaged task and, if possible, continue, system operation. If the system cannot 
continue because the failure occurred in an area critical to system operation, 
recording is attempted, after which the system enters a hard wait state. 

When a hard MCI is caused by an unrepairable real storage position, MCAR 
dynamically reallocates storage. Informative messages are printed on SYSLOG 
that alert the operator of any action taken by DRAP. 

MCAR Modes of Operation: An error Frequency Limit (EFL) algorithm prevents 
SYSREC from filling up too quickly if a large number of intermittent failures 
occur. The initial IBM -supplied EFL and either eight (Models 155-11 and 158) or 
sixteen (Model 145; eight for control storage and eight for processor storage) soft 
ECC MCIs within an eight-hour period. These values are set at system generation 
time and can be changed by the MODE command. A message is issued on the first 
occurrence of a soft MCI on a System/370 Model 135 and all recoverable machine 
checks are disabled. The MODE command must be issued to re-enable reporting of 
soft machine checks. These values are set at system generation time but can be 
changed by the MODE command. 

MCAR supports EFL for two hardware facilities: 

• Hardware Instruction Retry 

• Error Checking and Correction. 

EFL Threshold Values; At IPL time, the EFL threshold values are established so 
that the EFL algorithm controls the number of soft MCIs recorded. These 
values are: 

• The number of soft MCIs 

• A specific time period. 

When these EFL values are reached, a change in moderof operation occurs. Until 
the EFL threshold values are reached, the system operates in recording mode. 
This is the normal mode of operation in which an MCI occurs for all machine 
check conditions. After the EFL threshold values are reached, ECC (or ECC and 
HIR) is placed in quiet mode. In quiet mode, no MCIs occur for recovered errors; 
therefore, the number of corrected errors is unknown. 

EFL threshold values are not applicable to the Models 115 and 125 owing to the 
recording of erros by a hardware function. 
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Hardware Instruction Retry (HIR) Modes: The two HIR modes are: RMS 

• Recording. A soft MCI occurs for every hardware instruction correction. 

• Quiet. No soft MCI occurs for hardware instruction correction. (Recording 
is always quiet for the Model 125.) 

Error Checking and Correction (ECC) Modes: The ECC modes are: 

• Recording. A soft MCI occurs for every main or control storage correction. 

• Quiet. No soft MCI occurs for real or control storage correction. (Recording 
is always quiet for the Model 125.) 

• Threshold (Model 145 only). A soft MCI occurs after a predetermined 
number of unrecorded control storage errors have occurred within a given 
time period. Threshold mode is a hardware function and is not affected by 
EFL threshold values. 

If HIR is in quiet mode, ECC is also in quiet mode. When ECC is in quiet mode, 
HIR can still be in recording mode. 

At IPL time the system assumes the IBM-supplied EFL threshold values; these 
values can be changed by the MODE command. When IPL is completed: 

• For the Model 145, recording mode is entered for HIR, quiet mode is 
entered for main storage ECC, and threshold mode is entered for control 
storage ECC. 

• For the Models 155-1 1 and 158, full recording mode is entered for both 
HIR and ECC 

Channel Check Handler (CCH) 

When a channel check occurs, channel error information is logged and an interrupt 
is generated. The CCH resident program investigates the severity of the malfunction. 
If the severity is such that system operation need not be immediately terminated, 
the CCH resident program: 

• Builds the Error Recovery Program Interface Bytes (ERPIB) containing 
error information for use by the appropriate CCH/ERP 

• Records the error information on the recorder file 

• Attempts to isolate the error to a device. 

If the error cannot be isolated to a device, CCH cancels all problem programs that 
use the malfunctioning channel. If the error can be isolated to a device and the 
device is supported by a CCH/ERP, the appropriate CCH/ERP is loaded into the 
R-transient Area (RTA). Then ERP examines the ERPIB supplied by CCH and 
determines the severity of the error. Whenever possible, the failing channel 
command is retried. If the command cannot be retried, or if retry fails, a message 
is written on SYSLOG, and all problem programs using the failing device are 
cancelled. If recovery is successful, a message is also written on SYSLOG, unless 
SYSLOG was the failing device. Certain retry conditions require manual operator 
intervention to enable proper retry. 

Note: If the 'accept unrecoverable error' bit in the CCB is on, the error is posted 
and control is returned to the problem program. 

If no CCH/ERP is available for an error isolated to a device, all problem programs 
using that device are cancelled. 
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Error Recovery Procedures (ERP) for I/O Devices: 

Each I/O device or class of I/O devices has a unique device error recovery routine. 
The appropriate routine is entered from the channel scheduler upon detection of 
an error. The function of the error recovery procedures (ERP) is to attempt 
recovery from the error either through programmed recovery or by operator 
intervention. If recovery is not possible, the following choices are available, where 
applicable: 

1. The error can be ignored. 

2. The task can be terminated. 

3. The problem program can take action (exit to a user routine). 

4. The record in error can be bypassed. 

Depending on the type of error, the type of device, and whether Logical IOCS 
is used, some or all of these options are available. Choices 3 and 4 are available 
through LIOCS only. In the absence of any other options, only choice 2 is 
available. 

At the time the error is first detected, before ERP is called to attempt recovery, 
RMSR accumulates certain information relating to the status of the device in the 
PUB2 for the device. The device ERP then gets control and tries to correct the 
error. If the ERP cannot recover, RMSR builds and writes the unit check record, 
containing the statistical data from the PUB2 and the status and sense information 
at the time the ERP determined the error was unrecoverable. If the ERP recovers, 
the statistical data in the PUB2 is not cleared. This information is recorded at the 
next permanent error for that device, at the next statistical counter overflow for 
that device, or at end-of-day when the operator issues the ROD command. 

Besides the unit check record (written for every permanent error) and the counter 

overflow record (written when a statistical counter becomes full or when the 

operator issues the ROD command), RMSR also writes Tape Volume Dismounts 

records. The data recorded in the Tape Volume Dismount records corresponds 

to the data formerly accumulated in the TEBV table; the EREP TES (Tape Error /if A 

Statistics) options are used to format and summarize this data. 
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SYSREC (System Recorder File) 

The recorder file must be created and assigned to a disk device that is always on 
line. It is assigned after IPL, before the first job. 

The recorder file is not CPU or SYSREC dependent. Thus it can contain records 
from more than one DOS/VS system. 

Once the file is created, no further operator intervention is required, unless the 
recorder file is damaged or the operator action listed in the DOS/VS Messages 
manual specifically requests the file to be re-created. For example, message 

0T03I ERROR ON RECORDER FILE. 

On subsequent IPLs the system opens the recorder file and continues to update it. 

Note: Recording on the recorder file is suppressed during execution of the 
EREP program. 

Creating the Recorder File: The method of creating SYSREC and the job stream 
needed depends on whether the file is to be part of the system residence unit 
SYSREC, or whether it is to reside on a separate disk volume. 

For details and job stream examples, refer to the DOS/VS System Management 
Guide. 

SYSREC Record Types: SYSREC contains variable-length records with a maximum 
size of 200 bytes (including a standard 24-byte header). The types of recording 
that RMSR performs are: 

• MCAR recordings 

• CCH recordings 

• Unit check recordings 

• Counter overflow recordings 

• Tape volume statistics recordings 

• IPL/EOD recordings 

• Miscellaneous Data Recorder (MDR) recordings 

• Teleprocessing error records (TPER). 

MCAR: Formats an environment record (recovery report) after a soft machine 
check. 

The record is written on the environment recorder data set (ERDS), which has 
the symbolic name SYSREC. The record contains the following pertinent 
information about the error: 

Status information from the fixed logout area in real storage 

Recovery action 

Program identification 

Date 

Time of day. 

CCH: Formats an error information block for use by the ERP routines after an I/O 
interrupt, caused by a channel check. 

The record is written on SYSREC, and contains the following information: 

• Status information from the logout area 

• The ECSW (extended channel status word) 

• Date 

• Tirhe of day. 

MCAR also records data on SYSREC about hard machine checks. 



RMS 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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RMS UNIT CHECK RECORD: Device ERPs attempt recovery from an error, usually 

by retrying the failing channel command. If the error is not corrected after a 
certain number of retries, RMSR writes a unit check record which contains 
hardware information (sense data), statistical data, and identification data. All 
information relevant to the status of the device at the time the failure is recognized 
as permanent is contained in this record. One unit check record is written for each 
permanent error. RMSR resets the statistical counters in the PUB2 table at the 
same time. 

COUNTER O VERFLOW RECORD: Whenever a statistical counter in the PUB2 
table fills up, a counter overflow record is written on SYSREC. The counter 
overflow record is also written for each device that has unrecorded statistics when 
the operator issues the ROD command. The statistical counters in the PUB2 table 
for the device are cleared at the same time. 

IPL/EOD: I/O error logging for System/370 users includes RDE (Reliability Data 
Extractor). If ERRLOG=RDE is specified during system generation, RDE gathers 
hardware reUability data that IBM personnel use to evaluate hardware performance. 
Two types of records are written on SYSREC by RDE: 

• An IPL record. This specifies the reason for IPL. 

• An EOD (End-of-Day) record. This is initiated by the ROD command, which 
should be issued before the system is shut down. 

EREP uses these records to identify RDE data. 

For the System/370 Models 115 and 125 the operator must save the disk usage 
counters at the end of the day (or end of shift or prior to system switch-off) by 
using the U command of the mode select display. 

MISCELLANEOUS DATA RECORDER (MDR): RMSR makes recordings on the 
SYSREC file for the 321 1 printer buffer errors and the 3330 and 3340 Disk 
Storage errors. 

TAPE VOLUME DISMOUNT RECORD: When processing standard labelled tapes 

using LIOCS, RMSR makes a recording on SYSREC each time a new volume serial ,4"~\ 

number is detected. When the tape is opened, the number of the current tape is U J 

compared with the serial number in the PUB2 for that tape drive. If the serial 

numbers are different, a volume dismount record, containing volume usage and 

Tape ERP recovery statistics, is written on SYSREC. The statistical counters in the 

PUB2 relating to usage and error recovery action are cleared and the serial number 

is updated. Processing continues and statistical data for the new tape is accumulated 

in the PUB2 table. 
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TES (Tape Error Statistics) R MS 

A major factor affecting the quality of an operating system is the condition of the 
volume stored on a magnetic medium, such as tape. Such a medium is subject to 
contamination from dust, foreign materials, fingerprints, and particles of oxide 
coating. 

Because of these environmental factors, it is desirable to record the number of 
read and write errors occurring on each tape volume. By monitoring the error 
rate, a report can be kept on the condition of each tape volume in a tape library. 

System Requirements: For Tape Cartridge Readers. When error statistics are 
required to monitor tape cartridges used on the 2495 Tape Cartridge Reader 
specify TEB = n in the FOPT macro, (n specifies the number of tape cartridge 
readers attached to the system.) 

For magnetic tape volumes when error statistics are required to monitor tape 
volumes, specify TEVB=IR or CR in the FOPT macro. 

For all standard labeled tapes, tape statistics are accumulated by volume. For 
unlabeled and nonstandard labeled tapes two types of error recording are 
available: 

• Combined Recording (CR) 

• Individual Recording (IR). 

When TEBV=CR is specified, the error statistics for all unlabeled and nonstandard 
labeled tapes on a specific tape unit are accumulated until a labeled tape is 
mounted and opened on that unit. Then, one recording for the unlabeled and 
nonstandard labeled tapes is made, and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file and to reset 
the PUB2 table counters at each OPEN for unlabeled and nonstandard labeled 
tapes. 

The mode of recording for nonstandard labeled and unlabeled tapes can be 
changed with the tape options of the operator's MODE command. 
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Not applicable to the 
Models 115 and 125 
using a supervisor 
that does not support 
the RMSR function 



EVA (Error Volume Analysis) 

This option of RMSR enables you to specify the number of temporary read/write 
errors that can occur on a tape volume before an informatory message is printed 
on SYS LOG. 

System Requirements: The number of temporary read/write errors needed to 
print the informatory message must be specified by EVA=r and/or w the FOPT 
macro during system generation, (r specifies the threshold level of temporary read 
errors, and w specifies the threshold level of temporary write errors.) 

Description and operation: The message that EVA issues to SYSLOG contains the 
number of temporary read errors, temporary write errors, and START I/Os, the 
physical unit identification, and if standard labeled tape is used, the volume serial 
number. 

The message format is: 

4E10I xxxxxx cuu TR-nnn TW-nnn SlO-nnnnn 

where: 

xxxxxx Serial number of standard label volume (blank 

when nonstandard or unlabeled volume is 

being used) 
cuu Channel/unit address (physical unit) 
TR-nnn Number of temporary read errors 
TW-nnn Number of temporary write errors 
SlO-nnnn Number of START l/Os. 

Either the TR=nnn or the TW=nnn field contains one or more than the 
predetermined error threshold specified in the FOPT macro. When the threshold 
is reached, a notification, for example, OPl 1 , is sent to the system operator. There 
is no interruption in the execution of the problem program. 

How and when to use: When using an unlabeled or nonstandard labeled tape, a 
note can be made of the volume identification of the volume in use when the 
message is received in order to monitor it. 

By monitoring your magnetic tape volumes, a record can be accumulated of 
read/write errors per volume. 

Operational delays caused by old or worn tapes can be avoided by cleaning and 
erasing the volume, or by cutting off the first ten yards of the volume that indicates 
read/write errors. 

Note: The first part of a tape volume contains label information and is the part of 
the tape that suffers more from mechanical friction. Therefore, the oxide coating 
is more likely to cause read /write errors on the first part of a tape than on any 
other part. 
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Operator commands for controlling RMS 

The error recording facility is under the control of the operator. In addition to 
creating the recorder file (SET RF=CREATE) and responding to error messages, 
the operator has the following responsibilities: 

• Matching PUB2 space to devices attached 

• Issuing the ROD command in response to the problem determination action 
of an error message, or prior to turning the system off or performing a 
re-PIL 

• Providing IPL reason information (RDE users only) 

• Issuing the MODE command to set the type of recording accomplished by 
the MCAR/CCH, CE, and tape error statistics portions of RMSR 

• Executing the EREP program and directing EREP to perform the correct 
function. 

The following sections describe these items more fully. 



Matching PUB2 space to devices attacfied to the system 

During IPL, the following message may be issued: 

01291 INSUFFICIENT PUB2 SPACE AVAILABLE, RE-IPL 

IPL is automatically canceled, and during the re-IPL the operator must delete 
devices until the above message is no longer issued. 

The reason for this message may be a change in system configuration since 
supervisor generation, or it may be that the supervisor in use has not been 
generated for the same amount and type of disk and tape devices. PUB2 (a table 
in the supervisor) contains a counter for statistical data on device operation and 
is used by the RMSR routines. 

Parameters of the lOTAB supervisor generation macro increase the size of PUB2 
to accommodate the counters for devices attached to your system that require a 
larger field than the standard 12-byte PUB2 field. 

The PUB2 table is described in more detail in the DOS /VS Supervisor manual. 

iPL/EOD (End-of-Day) recording 

This RMSR facihty enables data to be recorded on the system recorder file 
(SYSREC) about the reason for, and time between, operator IPLs. 

This allows IBM and installation management to monitor IPLs for any selected 
time period, for example, during an 8 hour operator shift. 

When RDE is required, specify ERRLOG=RDE in the SUPVR macro during 
system generation. 

The ROD command (Record on Demand) 

Using this command will ensure that any statistical data held in the PUB2 table 
is added to the recorder file. For System/370 RDE users, the ROD command also 
writes the EOD (End-of-Day) record on SYSREC. The command ROD has no 
operand. BTAM and QTAM use their own separate methods of updating all disk 
counters during closedown or cancel. 

For the System/370 Models 115 and 125, the operator must save the disk usage 
counters at the end of the day (or end of shift or before system switch-off) by 
using the U command of the mode select display. 
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Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 



When to use: 

1. Operator actions listed under appropriate messages in DOS /VS Messages 
indicate when to issue this command. 

2. In order to create meaningful END-OF-DAY records on the system recorder 
file, you must respond with y to the message END-OF-DAY= at system 
shutdown or at the end of every shift. 

(If the END-OF-DAY record is not required, respond with n to the END-OF-DAY= 
message.) 

IPL reason information 

During the processing of the first // JOB statement after IPL, RDE users must 
provide additional information about the system. Message 1I90D IPL REASON 
CODE= is issued on SYSLOG. You must respond to message 1I90D with a Reason 
Code followed by End. 

If a Reason Code is not entered (only the END key is pressed) or if SYSLOG is 
down or not assigned to a 3210, a 3215 or a Model 125 video display unit, then 
the default, DF, is assumed. However, if an invalid code is entered, message 1I89I 
is issued and message 1I90D is reissued until a vahd response is made. 

After the Reason Code is entered, message 119 ID SUB-SYSTEM ID= is issued. 
You must respond to message 119 ID with one of the ID codes followed by END. 
The ID codes further identify the reason for performing IPL. The ID codes and 
the reasons are shown in the table below. 



o 



IPL REASON CODE 

CE IBM CE/SE has control of the system 

and is not doing user work. 
DF Default; 

EN Environmental problem (such as: power, 
overheating, etc.) caused failure. 

IE IBM hardware or a IBM-supplied-program 

error that did not require an IBM CE/SE. 
IM IBM hardware of IBM-supplied-program 

error that required an IBM CE/SE. 
ME Media. Hardware error caused by a faulty 

disk pack, reel of tape, cards, etc. 
NM Normal IPL. 
OP Operational problem. Operator error 

or procedural problem. 

UN Unknown. Undetermined error. 

UP A user (non-1 BM-supplied) program caused 
the failure. 



SUB-SYSTEM ID 

00 Unknown. Must be used with Reason Codes DF, EN, NM, OP, UN and UP. 

00 is the default. 
10 Processor. CPU, channel (integrated), storage unit, etc. failure. 
20 DASD. A failure occurred in a DASD unit or its associated control unit 

(231 1 , 2314, 2319, 2841 , 3330/3333, etc.) 
30 Other. A device without an ID code (such as a paper tape unit) caused the 

failure. 

40 Magnetic Tape. A failure occurred in a magnetic tape unit or its associated 
control unit (2400, 3400, etc.) 

50 A failure occurred in a card reader /punch, a printer or in its associated 

control unit (2540, 3525, 1403, 2821 , etc.) 
60 MICR/OCR. A magnetic ink character reader (1412, 1419, etc.) or an optical 

character reader (1285, 1287, 1288, etc.) failure. 
70 A teleprocessing failure occurred in a teleprocessing control unit 

(2701,2702, 3705, etc.) 
80 Graphic. A video display unit (2260, etc.) or its associated control unit 

failure. 

90 An IBM-supplied SCP Type 1 or Type 2 program (such as the DOS/VS 
system or one of its components) failure. 

91 An IBM Programming Product failure. 



\J 



Table F-2-A IPL reason codes 



If the ID code is not entered (only the END/ENTER key is pressed) or if SYSLOG 
is down or not assigned to a 3210, a 3215 or a Model 125 video display unit then 
the default, 00, is assumed. However, if an invalid ID code is specified, message 
1I89I is issued and message 119 ID is repeated until a valid response is made. 

Notes: 

1. Always use ID code 00 with Reason Codes DF, EN, NM, OP, UN, and UP. 
1 ID codes 10, 20, 30, 40, 50, 60, 70, 80, 90, and 91 should be used with Reason 
Codes CE, IE, IM, and ME. 

Normal processing continues after the IPL information has been specified. In order 
to create meaningful data on average running time per IPL, you must issue the 
ROD command before the system is shut down at the end of the working day, or 
at the end of a shift. By this procedure, an accurate record can be maintained on 
the system recorder file, which is printed periodically using an EREP option 
explained later in this section. 



^itei 
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The MODE command 

This command should be used only at the request of your IBM customer engineer. 

/IR 
CR 
CE,cuu 



RMS 



MODE -< 



Not applicable 
to the Model 125 



R 

STATUS 
HIR 
ECC 



,l[,xx,y] 

,D[,xx,y] 

.N 



# 



[,E=eeee] [,T=tttt]! 



*Note: When either HIR or ECC is specified, at least one of the optional operands 
within these braces must be selected. THis only valid for the Model 145 when 
ECC,C is specified with the MODE command. 

The mode command provides the following options for controlling RMSR: 
Reset the recording mode for unlabeled and nonstandard tapes. 
Set recording mode for a particular device to intensive, diagnostic, or no 
mode. 

Initiate or suppress HIR (Hardware Instruction Retry) and ECC (Error 
Correction Code) error recording. 

Request the Mode that the system is operating in (the status of the system). 
Change the mode of operation from Q (quiet) to R (recording) or from 
RtoQ. 

Specify EFL threshold value to override the IBM-supplied value. 
Place the Model 145 Control Storage ECC in threshold mode. 

The MODE command is a notational command. Operands of the MODE command 
can be entered in any order and must be continuous with no blanks between or 
within operands). The STATUS operand cannot have any other operands before 
or after it. 

The total length of the MODE command must not exceed 30 characters. 

The table below describes the parameters for the MODE command: 




Note: Not applicable to the 
Models 115 and 125 using a 
supervisor that does not support 
the RMSR function. 



Note: Not applicable to the 
Models 115 and 125. 



Operand 


Description 


IR 
CR 


Recording mode for nonstandard labeled and uYiiabeled tape. Specify Individual Recording (IR) if you wish to record 
and then reset the tape error statistics at each tape OPEN. Specify Combined Recording (CR) to accumulate all the 
statistics from nonstandard labeled and unlabeled tape on a specific tape unit until a standard labeled tape is opened. 
Then one recording of the statistics from all the nonstandard labeled and unlabeled tapes is made on SYSREC, and 
the statistical counters are reset in the PUB2 table. 


CE 


The recording mode for a device at physical location X'cuu' may be reset. The possible recording modes are: 

b Normal. The default, normal, is assumed. 

1 Intensive. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the next 

seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for success is 

also recorded. 
D Diagnostic. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the 

next seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for 

success is also recorded. 
N No recording. 

When the recording mode parameter is the last parameter of the MODE command, a check is made to see if all errors 
are recorded. When in intensive or diagnostic mode, it is possible to check for only one type of error. Indicate the 
bit to be examined with: 
(xx,y) where y is the bit (0—7) and xx the byte (0—31 ) of sense data to be checked. 



Parameters for the MODE Command, (part 1 of 2). 
Table F-2-B 
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Operand 


Description 


STATUS 
Not applicable 
to Models 1 15 
and 125 


On SYSLOG a report is printed which indicates: 

• Thetypeof facility used (HIR, ECC) 

• System nx)de of operation 

• Current error count 

• Error count threshold 

• Current elapsed time 

• Time threshold 

• Number of buffer pages deleted. 
The status report formats are: 

HIR,. >,aaaa/eeee,bbbb/tttt 

For the Model 135: 

For the Model 145: 

R M 
ECC, Q, C,aaaa/eeee,bbbb/tttt 

For the Models 155-11 and 158: 
^CCA ^ ,aaaa/eeee,bbbb/tttt 

BUF DLT=XXX 

where: 

aaaa = Current error count 

eeee = Error count threshold 

bbbb = Current elapsed time 

tttt = Time threshold 

XXX = Total number of inoperable buffer pages deleted. 


HIR 

Note applicable . 
to Models 1 15 
and 1)25 


Hardware Instruction Retry. This operand changes the mode of the HIR facility to R or Q and/or modifies 

the error count threshold and/or time threshold. 

Note: When HIR is placed in quiet mode, ECC also goes into quiet mode. 


ECC 

Not applicable 
to Models 1 15 
and 125 


Error Correction Code. This operand changes the mode of the ECC facility to R or Q, and/or modifies the 
error count threshold and/or time threshold. ECC,R and ECC.Q are the only valid modes of diagnosis for the 
Model 1 35. If ECC is specified for a Model 145, M or C must also be specified. ECC can also place the 
Model 145 control storage in threshold mode. 

Note: Use of the Error Correction Code (ECC) in full recording mode may cause severe system degradation. 
Thus, the (ECC, M/C,R) operand combination of the mode command should only be used by the customer 
engineer or at his request. 


R 


Recording Mode 

MODE R - places both HIR and ECC in recording mode. 

MODE HIR,R — places HIR in recording mode. 

MODE ECC,M,R (Model 145) — if HIR is already in recording mode, main storage is placed in recording mode. 

MODE ECC,C,R (Model 145) - if HIR is already in recording mode, control storage is placed in recording 

mode. 

MODE ECC, R (Models 155-11 and 158) - if HIR is already in recording mode, it places ECC in recording 

mode. 


Q 

Not applicable 
to Models 1 15 
and 125 


Quiet Mode 

MODE HIR,Q - places both HIR and ECC in quiet mode. 

MODE EEC,Q (Model 135, 155-11 and 158) places ECC in quiet mode. 

MODE ECC,M,Q (Model 145) — places main storage in quiet mode. 

MODE ECC,C,Q (Model 145) — places control storage in quiet mode. 


Mor C 

Note applicable 
to Models 1 15 
and 125 


Main or control storage: M or C is only valid for the Model 1 45. 
M or C must be specified when ECC is specified for the Model 145. 
M indicates main storage and C control storage. 


TH 


Treshold Mode: on the next occurrence of an ECC control storage error, control storage is placed in quiet 
mode. TH is only valid for the Model 145 if ECC,C is specified. TH places the Model 145 control storage 
ECC in threshold mode. 


E=eeee 
T=tttt 


Values entered for E and T must be within the following decimal ranges: 

E-8 (initial value) through 9999 (Error Count threshold) 

T-8 (initial value) through 9999 (Time threshold) 

The IBM-supplied value is 8. 

Note: Whenever HIR is in quiet mode, ECC mode must not be changed. 

For the Model 1 35, the only valid mode commands are: 

MODE CE,... 

MODE STATUS 

MODE ECC,Q 

MODE ECC,R 






Table F-2-B Parameters of the MODE Command, (part 2 of 2). 
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Hardware Error Recording and Recovery 

The EREP program edits and prints error statistics records that have been stored on ER EP 

the recorder file (SYSREC) by RMSR. 

Note: Not applicable to the 
System Requirements Models 115 and 125 using 

a supervisor that does not 
Before it can be executed, EREP must be cataloged to the core image library. support the RMSR function 

Check with the person in your installation who is responsible for creating or 
maintaining the core image library to ensure that the EREP program is cataloged. 
The hnk-edit statements for cataloging EREP are in the DOS /VS System Generation 
manual. 

The EREP program is a modular, self-re locating program. If the supervisor is 
batched-job only, however, EREP must be link -edited to the end-of-supervisor 
address. It can run in a real or virtual partition using standard job control 
statements. When the environmental data is needed or the SYSREC file becomes 
full, EREP can be executed from SYSLOG or SYSIPT. 

EREP can perform any combination of the following options: 
Edit/print the entire SYSREC file 
Create or update the history/RDE tapes 

Selectively retrieve records from the SYSREC file or history/RDE tapes 
for editing and printing 
Summarize the SYSREC file 
Create or update a TES history tape 
Edit/print TES data from the SYSREC file 
Summarize TES data from the SYSREC file or history tape 
Clear the SYSREC file. 

Tables F-3-A and B show how the options are selected and table F-3-C Hsts the 
logical unit assignments required by EREP. Table F-3-D and the text following 
gives a detailed description of these options. Flowchart F-3-F shows the procedure 
for executing EREP. 
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EREP 



EDIT 
CLEAR 

SUM 1 GROUP 



OPTION \ HIST [,NEW] [,2] 
UPNEW 
TES --I OPTION TES 



SELECT 
RDESUM 



[,NEW] rPRINT[,SUM[,SUMTAPE]] [,VOL]| 

[,SUM[,SUMTAPE] [,VOL] 

,NOTAPE y,PRINT[,SUM[,SUMTAPE] ] [,VOL]' 

\,SUM[,SUMTAPE] [,VOL] j 



Table F-3-A. The options for TES (Tape Error Statistics) 



DISK 

DISKETTE 
TAPE 
MICR/OCR 
GROUP=< UNITREC 
TP 
CPU 
2715 
ALL 



Table F-3-B. Parameters for the SUM option. 



CPU=xxxxxx,yyyy 

where xxxxxx = the CPU volume serial 
number 
yyyy = the CPU model number. 






LOGICAL UNIT 


COMMENTS 


SYSIPT 


Optional 


SYS LOG 


Required, must be assigned to a 3210, 3215 or 
a Model 125 video display unit 


SYSREC 


Required 


SYS007 
SYS008 


Optional; must be assigned to a magnetic tape unit 
when a TES option is specified. 


SYS009 


Optional; must be assigned to a magnetic tape unit 
for history /RDE options. 



Table F-3-C. Logical units required by EREP. 
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OPTION 


RESULT 


OPTION EDIT 


Edits and prints SYSREC onto SYSLST. 


OPTION CLEAR 


1 .- Edits and prints SYSREC onto SYSLST 
2. Clears SYSREC. 


OPTION SL 
GROUP= -< 
CPU=xxxxx 


M 

/^DISK 1 

DISKETTE 

TAPE 

MICR/OCR 

UNITREC y 

TP 

CPU 

2715 
^ALL ) 

x,yyyy 


Prints the summarization of SYSREC onto SYSLST. The file is summarized by the 
hardware group(s) listed in the GROUP parameter. 

If records from multiple CPUs appear on the SYSREC file, specify the serial number 
(xxxxxx) and model number (yyyy) of the CPU whose records you wish to have 
summarized. If CPU data is not supplied, records from all CPUs appearing on the 
SYSREC file are summed together. 


OPTION HIST, NEW [,2] 


1 . Creates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION HIST[,2] 


1 . Updates the history /RDE tape on SYS009 

2. Clears SYSREC. 


OPTION EDIT 

followed by 

OPTION HIST,NEW or OPTION HIST 


1 . Edits and prints SYSREC onto SYSLST 

2. Creates or updates the history /RDE tape on SYS009 

3. Clears SYSREC. 






OPTION TES,NEW 


Creates a TES history tape on SYS007. 


OPTION TES 


Updates a TES history on SYS007. 


OPTION TES,NOTAPE,PRINT 


Edits and prints tape error data from SYSREC onto SYSLST. The data is printed in 
the detail tape unit format. 


OPTION TES,PRINT,NEW 


1 . Creates a TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,PRINT 


1 . Updates the TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,NOTAPE,SUM 


Prints the summarized tape data from SYSREC onto SYSLST in the detail tape 
unit format. 


OPTION TES,NOTAPE,PRINT,SUM 


1 . Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 

2. Prints the summarization of the tape data from SYSREC onto SYSLST in the 
summarized tape unit format. 


OPTION TES,SUM,VOL 


1 . Updates the TES history tape on SYS007 

2. Summarizes the tape error data on SYSREC by volume serial number. 


OPTION TES,PRINT,VOL 


1 . Updates the TES history tape on SYS007 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format. 


OPTION TES,PRINT,SUM,SUMTAPE,VOL 


1 . Updates the TES history tape on SYS007. 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format 

3. Summarizes the tape error data on the history tape and prints it on SYSLST 
in the summarized volume serial number format. 


OPTION TES,NOTAPE,SUM,SUMTAPE 


Summarizes the tape error data on the history file and prints it on SYSLST in the 
summarized tape unit format. 


OPTION SELECT (see note 1) 


Selectively prints records from SYSREC onto SYSLST. 


OPTION SELECT ,TAPE (see note 1) 


Selectively prints records from the history /RDE tape onto SYSLST. 


OPTION RDESUM 
(none) 


Summarizes the IPL, EOD, MCAR, CCH, and Unit Check records for a specified 
period of from one to 30 days. These records are on the history /RDE tape 
(see note 2). 

Edits and prints SYSREC onto SYSLST. 


Note 1. Records are selected by specifying select parameters. 

Note 2. RDESUM does not summarize across multiple volumes. If EOF is encountered before the entire requested reporting period 
has been covered (this can be checked through the end date printed on the RDESUM listing), rerun RDESUM using the next 
volume history /RDE file nad the same reporting period you specified during the first RDESUM execution. A listing with 
the remainder of the requested information is thus generated. 



EREP 



Table F-3-D. The EREP options 
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EREP Description of EREP Options 

EDIT 



The EDIT option causes EREP to edit and print the contents of the SYSREC ^,„/' 

file on SYSLST. The unit check records are displayed first and are grouped by 
CUA (channel and unit address) within each device group (unsupported, tape, 
disk, TP, unit record, MICR/OCR). 

After the unit check records, the channel check, machine check, 2715, and 
IPL/EOD records are displayed. Retain these printouts for problem determination. 

EREP displays IBM 2715 error records from the SYSREC file in this order: 

1. Disk adapters 

2. 2790 loop adapter 

3. MPX adapters 

4. 2750 adapters. 

5. BSC adapters. 

The special code records are grouped for editing and printing by area station 
address, CUA, and special code. All area station records on SYSREC are 
summarized by device address, area station, ID, and CUA during editing and 
printing. 

EREP EDIT can execute in a 14K partition, but performance may be improved by 
allocating more than 14K (up to 42K) to the EREP partition. Storage allocation 
should be increased in blocks of 4K because the tables that EREP EDIT uses are 
each 3.5K in size. This applies only when EREP is executed in real mode. 

CLEAR: The CLEAR option causes EREP to clear (reset) the entire SYSREC file 

for RMSR recording. If the CLEAR option is specified by itself, the EDIT option 

is forced. CLEAR is always the last EREP function performed. CLEAR is forced 

if HIST, or HIST with optional parameters, is specified. ^^ 



Note: If a hard I/O error occurs on SYSREC while the CLEA R function of EREP 
is running, EREP will abnormally end and the operator should re-IPL the system. 
In a MPS system, it may be undesirable to re-IPL. If you do not re-IPL, however, 
the contents of the SYSREC file will be unpredictable. 



XJ 



o 
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SUM 

The SUM option allows hardware groups on SYSRES file to be summarized. 
This function can: 

• Accumulate certain bits and bytes in CPU logouts within MCAR/CCH 
records 

• Accumulate statistical and sense byte data from unit check records 

• Summarize area station data in 27 1 5 error records by device address, area 
station, ID, and channel and unit address. 

The SYSREC file may be summarized, or one or more hardware groups may be 
summarized. The GROUP parameter should immediately follow OPTION SUM. 



EREP 



Note: This option is only 
applicable to the Model 145. 






DISK 

DISKETTE 
TAPE 
, MICR/OCR 
GROUP= < UNITREC 
TP 
CPU 
2715 
ALL 



These entries separated by commas may be made in any order. If the GROUP 
parameter does not follow OPTION SUM or if it contains an error which the 
operator does not correct, the EREP program summaries the SYSREC file for 
the tape hardware group. 

If the SYSREC file contains records of multiple CPUs, the CPU whose records are 
to be summarized must be defined by entering 

CPU = xxxxxx,yyyy 

in which xxxxxx = the CPU serial number 
yyyy =the CPU model number. 

If no CPU is provided, records from all CPUs appearing in the SYSREC file are 
summed together. 

You can execute the SUM option more than once during an EREP run if you 
enter the option and parameter control statements via SYSLOG. After the 
summary is performed with one set of parameters, the message 

3E05A ENTER SUMMARY PARAMETERS 
is printed on SYSLOG. You may enter the parameters for another summary at 
this time, or end execution of the SUM function by responding with CANCEL 
and pressing the END or ENTER key. 

If GROUP=ALL is specified, EREP does not ask for additional parameters because 
a summary of all records is made. 

When the summary has been completed, EREP processes the next option, if any. 

It is possible to reduce the processing time for the SUM function by allocating more \ 
main storage (in blocks of 8K) to the partition in which EREP is to run. The root 
phase requires 2K and each transient 8K. The disk, tape, and unit record group use 
two transients; other hardware groups require only one transient. 

When 2715 is specified in the GROUP parameter, the 2715 records are summarized 
before any other hardware group. The 2715 group uses lOK of storage, even if 
more storage is available. If not all the 27 15 records can be processed in the lOK 
partition, those that can be are processed, after which the transient is reloaded and 
the next 2715 records are processed. This is done until all 2715 records are 
processed. 

In the 8K partition, the TP group can be process records for up to 60 distinct 
terminal names at one time. If more than 60 terminals are to be summarized, the 
file must be read more than once. If more than one hardware group is specified in a 
lOK partition, the transients overlay each other and the file must be read as many 
times as there are transients. 




Note: This applies only to 
EREP executed in real mode. 
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SELECT 

By means of the specified search parameters, EREP selects records to be printed. 
The SELECT option initiates the search for these records on SYSREC; for 
example, SELECT, TAPE causes a search of the history tape to be performed. 
The parameters of the SELECT option are called select parameters; they are 
checked for validity but not for logical relationship. For example, although an 
MCAR record has no VOL field, the parameters 

TYPE=IVICAR 
V0L=1 23456 

are considered valid. 

The possible select parameters are listed in the table below: 



SELECT PARAMETER 


RESULT 


CPU=xxxxxx 


All error records associated with a CPU may be selected for printing by entering the 
six digit CPU serial number. 


TYPE= ^ 


'MCAR" 

CCH 

IPL 

EOD 

TP 

UNIT 
.1275 J 


K 


A specific type of error record may be selected for printing. Any number of different 
types may be selected for each search. 


fyyddd.yyddd 
DATE= jyyddd 


- 


All recordings made within a time span (measured in days) may be selected for printing. 
If two dates, separated by a comma, are specified, all recordings made in that time span 
are selected. If only one date is specified, all recordings made on that day are selected 
for printing. 


TIME hhmm.hhmm 


All recordings made within a time span (measured in hours and minutes) may be 
selected for printing. 


JOB=xxxxxxxx 


All recordings made during the execution of a specific job may be selected for 
printing by specifying the eight-byte jobname from the job statement. 


VOL=xxxxxx 


The error records for a specific volume may be selected for printing by entering the 
six-byte volume serial number. 


TERM=xxxxxxxx 


The error records for a terminal may be selected by entering the eight-byte terminal 
name. 


CUA=xxxx 


Records may be selected for printing by entering the channel and unit address 
(in hexadecimal) or the line number for TP. 


DEVICE=xxxxxx 


The records associated with a specific type of device may be selected by entering the 
device type code (for example, 1403, 1442N1). 


FORIVIAT=TES 


Whenever a tape (2400 or 3400-series) error record is encountered, it is printed in the 
detail TES format by volume serial number. If FORMAT=TES is not specified, all 
tape error records are printed in the unit check format. 


Tare A 1 

SEL2715= J ADAPTER L 

[special J 


The 2715 records are printed in area station format if the SEL2715 parameter is not 
specified. If printing by area, adapter, br special is required, however, the SEL2715 
parameter must be specified. 



Table F-3-E. The select parameters. 



You may enter any combination of parameters; the EREP program assumes that 
you will only enter select parameters that apply to the records you want. If no 
select parameters are specified with the SELECT option, the MCAR records are 
selected and printed. 

The SELECT option can be executed more than once during an EREP run if the 
option and parameter control statements are entered via SYSLOG. After selective 
retrieval, when one set of select parameters has been completed, the message 

3E03A ENTER SELECT PARAMETERS 

is printed on SYSLOG. At this time, you may enter a new set of select parameters 
to execute the selective retrieval or you may end selective retrieval by responding 
with CANCEL and pressing the END or ENTER key. 
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RDESUM EREP 

The RDESUM option provides a summary of information about system operation 
during a specified 1 to 30 day period. This summary is created by searching the 
history/RDE tape, mounted on SYS009, for IPL, EOD, MCAR, CCH, and unit 
check records, after which these records are edited and printed on SYSLST. The 
information provided by the RDESUM option includes: 

• The starting and ending dates of the report. 

• The date, time, reason, and subsystem responsibility for each IPL. 

• The average run time betv^een IPL and EOD (or between two consecutive IPLs 
if the ROD command was not issued to create an EOD record) for the 
specified interval. If specified, the number of IPL records that occur in the 
cluster interval, (see note) 

• The subsystem responsibihty and number of times a subsystem caused a 
System Recovery Incident (a recoverable error that may cause system 
degradation) or a System Incident (an unrecoverable error that caused 
system failure). 

• If the history/RDE tape contains no records within the specified dates, an 
error message is printed and the report is terminated. 

• IPL records are not counted in the reports of sub-systems SI (System 
Recovery Incidents) 

• If an IPL record with a reason code of UN, IE, IM, ME or DF is immediately 
preceeded on the tape by an SRI that occurred within 30 minutes of the 
IPL, the SRI may be reclassified as an SI. The SRI is reclassified if (1) the 
subsystem ID specified for the IPL is the same as the device type of the SRI, 
or (2) if the subsystem ID is unknown (00). 

• Multiple SRIs on the same device are counted as a single SRI until there is a 
ten minute interval without an incident or an IPL record. 

• If an SI occurs within ten minutes of the IPL record following an SI, the SI is 
counted as a multiple occurrence of the first SI regardless of the subsystem 
involved. Intervening SRIs are ignored. 

• If 16 sequence errors occur on the history/RDE tape, RDESUM is 
terminated; if fewer than 16 sequence errors occur, the out-of-sequence 
records are ignored. 

Note: Clustering is the process of searching for multiple IPL records that have 
occurred within a specified number of minutes. Clustering can be used to detect 
multiple false starts that may distort other information provided by RDESUM. 

RDESUM is executed when the appropriate option card is encountered. The control 
information, including the start date for the report, the end date, the clustering 
interval if clustering is desired, and the company name, is entered once the 
EREPRDE phase is in main storage. The control information is entered in response 
to prompter messages. 

RDESUM does not summarize across multiple volumes of a history/RDE file. If 
EOF is encountered on the input tape, RDESUM goes to EOJ and the report 
printed reflects the information available from the start date to the last record 
on the tape. There may be some inaccuracy in the average run time per IPL 
(because RDESUM does not know when the EOD or next IPL record will occur, 
it uses the time of the last error record to compute the IPL period), but no other 
information is lost. 

RDESUM can be executed again for the next volume in the history/RDE file to 
obtain the remainder of the information for the desired reporting period. The 
previously specified period may be used on the subsequent volume because 
RDESUM starts with the first record on the tape if the specified start date is 
earlier than the date of the first record. 
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E R EP The following rules govern the method for summarizing RDE information: '^ 

• If the history/RDE tape does not contain information for a portion of the 
required time period, only those dates on the tape that fall within the time 
period are processed. The actual dates processed are reflected on the 
summary Usting. 

• If the starting date is defaulted, the first record on the tape is used to start 
the report. The report is stopped with the specified end date or, if that date 
is more than 30 days from the date of the first record processed, the 
thirtieth day processed. 

• If the end date is defaulted, the report is stopped with the last date on the 
tape or, if that date is more than 30 days from the starting date, on the 
thirtieth day processed. 

H/ST or HIST with Operands 

This option copies the data on the SYSREC file to the history/RDE tapes. All 
records on the tape(s) appear in chronological order. If an unrecoverable I/O 
error occurs while a record is being read from the SYSREC file, the record is 
ignored and processing continues with the next sequential record. If the data fills 
the complete tape, the message 

3E15ATAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END to 
continue processing, or he may respond with CANCEL and press END to cancel 
the HIST option. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 

before EREP is executed. The tape contains standard labels that are checked x' 

before the history/RDE tape is written. If the wrong tape is mounted, the message ' 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG, Mount the correct tape and press END to continue 
processing, or respond CANCEL END to cancel the HIST option. When the HIST 
option is specified, the CLEAR option is forced. The SYSREC file is cleared 
after the history/RDE tape has been created or updated, thus preventing 
redundant data from being transferred to the history/RDE tape the next time the 
HIST option is executed. 

HIST,NEW,[,2] : This optiefi causes EREP to create a history file on the tape unit 
assigned to SYS009. If 2 is also specified, a second history file is created on the 
same tape unit for RDE data. The data contained on both tapes is identical. The 
tape(s) contain the contents of the SYSREC file. The SYSREC file is cleared after 
all options have been executed. 

HIST.UPNEW: This option causes the tape file mounted on SYS009 (either 
history or RDE) to be updated, after which a new tape file is created. If UPNEW 
is specified, TLBL information for creation and updating must be included in the 
job stream. The SYSREC file is cleared when all options have been executed. 
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The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008. This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END, or he 
may respond CANCEL END; the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 
before EREP is executed. The tape contains standard labels that are checked 
before the history/RDE tape is written. If the wrong tape is mounted, the message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option is specified without the TES option, the SYSREC File is cleared after 
HIST has been executed, and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES, NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

into SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYS007, after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PRINT,SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007 is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRINT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and print pf' on SYSLST in the detail volume 

serial number format. SYS008 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
Appendix 0. 
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Y 
There are three types of EREP history tapes: the History tape, the RDE tape, and 
the TES history tape. The History and RDE tapes are created and updated from the 
SYSREC file and contain all the record types found on the SYSREC file. The TES 
history tape is also created from the SYSREC file, but contains only tape error 
records. If your installation has the History/RDE tapes and a TES history tape, you 
should create (or update) all the history tapes in the same run. If this procedure is 
not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 

History/RDE Tape 

The History/RDE tape is created and updated using the EREP history option. This 
tape contains RDE data only if ERRLOG=RDE is specified at system generation. A 
magnetic tape unit assigned to SYS007 must be used for this function. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is lin/c-edited as a self-relocating program, an LBLTYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A 
magnetic tape unit assigned to SYS007 must be used for this function. The filename 
of the tape file must be TAPEIN when the file is created and the file is updated. 



Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes, 
three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cancel only the HIST option. Any other response will cause the system 
to reissue message 3E16A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES,TAPE,NEW, and update 
it by specifying OPTION TES, TAPE. 
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Processing the tape error statistics with EREP 

The EREP (Environmental Recording, Editing, and Printing) program provides 
processing options for the tape error statistics records on SYSREC. 

Tape records can be edited and printed or summarized, together with the order 
records on SYSREC; you may also choose to have only the tape error records of 
the file selected or summarized. If the SYSREC file has been used to create a 
history/RDE tape, the records on that tape contain the same information as the 
SYSREC file contained. In this case the tape error statistics records can be selected 
or summarized from the history/RDE tape file. 

The SYSREC file may also be used to create a TES history tape. This tape contains 
tape error statistics records only. These records have the same format as the 
records of the former ESTV disk file; thus only part of the information recorded 
on the SYSREC file for tape error statistics is written on the TES history file. The 
information written on the TES history file consists of: 

Date the record was collected 

Physical address of the device on which the tape volume was mounted 

Number of temporary read errors 

Number of temporary write errors 

Number of permanent read errors 

Number of permanent write errors 

Number of error gaps encountered 

Number of noise blocks encountered 

Number of cleaner actions taken 

Number of SIO instructions issued 

Volume serial number if the tape was a standard labeled volume 

Block length if the volume contained fixed-length blocked records 

Tape density of the tape volume. 



EREP 
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The history /RDE tape and the TES history tape must always be updated in the 
same run. Failure to update both these tapes on the same run may result in 
redundant or lost data on the TES history tape. When PRINT is specified, the 
detail records on SYSREC are printed on SYSLST. When SUM is specified, the 
tape error statistics are summarized on either the history tape or SYSREC. 

It is possible to print or summarize tape error statistics by volume serial number 
or by tape drive address. 

When tape error statistics are summarized by volume serial number, it may be 
possible to reduce processing time by allocating more main storage to the EREP 
partition. Approximately 90 distinct volumes can be summarized in a lOK 
partition. When the SYSREC file contains recordings for more than 90 distinct 
volumes and EREP is run in a 1 OK partition, the SYSREC file is read and 90 volumes 
are summarized; then the SYSREC file is processed again and the remaining (or 
next 90) volumes are summarized. 

If you want to reduce processing time when there are more than 90 volumes, 
therefore, you must allocate enough storage, thus allowing all volumes to be 
summarized on only one read -through of the SYSREC file. Approximately 12 
additional volumes can be processed for each IK added to the partition. To 
calculate the number of volumes that can be summarized in a particular partition, 
use the following formula: 



o 



80 bytes 
if tape is 
assigned 



-2740 



N 

82 



/<'~^ 

w 
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Processing the TES H istory Tape with the ESTVUT Utility Program E R EP 

When a TES history tape is created from the data on SYSREC, ESTVUT (the 
ESTV Dump File Program) is used to process the data on the TES history tape. 
This utiUty program dumps the TES history file on SYSLST. 

ESTVUT consist of one module that has to be cataloged in the core image library. 
The module name to be used in the INCLUDE statement for this routine is 
IJBTESUT. 

Control Cards necessary to run ESTVUT. 

ESTVUT can be executed either from a card reader or from SYSLOG. An example 

of the job control statements required for ESTVUT is: 

//JOBESTVDUMP 

//ASSGNSYS005,X'181' 

// ASSGN SYSLST,X'OOE' 

//TLBLTAPEIN 

// LBLTYPTAPE 

// EXEC ESTVUT 

/* 

/& 

Symbolic Unit Assignments: Every sumbolic unit required for execution of the 
ESTVUT program must be assigned either temporarily for one job, or permanently. 

• SYS005 njust be assigned to the magnetic tape unit on which the TES 
history file is mounted. 

• SYSLOG must be assigned to a 3210, a 3215 or a Model 125 video display 
unit for all executions of ESTVUT in order to log inquiries and accept replies. 

Label information: Label information must be available to the system whenever 
the devices are used in the execution of ESTVUT 

• The first operand of the TLBL statement for the input tape must be 
TAPEIN 

• A LBLTYP for tape is required if the program uses tape and has been 
cataloged as a self-relocating program (+0 on the PHASE card). This 
statement reserves space for processing standard label information. 

Contents and format of printed output 

When the operator specifies a printer as the output device, the collected error 
statistics are formatted and printed as illustrated below: 




VOLUME 




TIME 


CHANNEL 


TEMP 


TEMP 


PERM 


SERIAL 


DATE 


OF DAY 


/UNIT 


READ 


WRITE 


READ 


xxxxxx 


yr/day 


hr.mn.sc. 


cuu 


nnn 


nnn 


nnn 


PERM 


NOISE 


ERASE 


CLEANER 


SIOS 


TAPE 


BLOCK 


WRITE 


BLOCKS 


GAPS 


ACTIONS 


USAGE 


DENSITY 


LENGTH 


nnn 


nnn 


nnn 


nnn 


nnnn 


nnn 


nnnn 



Each page of output contains 50 lines of data. 

On the last page, a message is printed below the last line of data. The message is: 
ESTV TAPE FILE DUMPED 
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Execute the EREP program at the request of the customer engineer or in response 

to an instruction in an error message. The operator commands necessary to ^'^ 

execute EREP through either SYSLOG or SYSRDR are: |^ 

PAUSE BG,EOJ 

//TLBL EREPNEW (see note 1) 

// EREPUP 

//TLBL TAPEIN (see note 2) 

TESUP 
//ASSGN SYS007,X'cuu' 
//ASSGN SYS008,X'cuu' (see note 3) 

// LBLTYP TAPE 
//EXEC EREP 

Note 1: This card is necessary only if you want to create or update either a 

history tape or a history tape and a Model 145 RDE tape. Use EREPNEW when 

creating and EREPUP when updating. 

Note 2: This card is necessary only if you are creating or updating the TES 

history tape. Use TAPEIN when creating and TESUP when updating. 

Note 3: This control card is necessary if you are updating or creating any of the 

history tapes (History tape, RDE tape, or TES history tape). 

Then EREP issues a message to the operator via SYSLOG or SYSIPT that is to be 
used for entering the EREP options. 

3E1ID ENTER OPTION SOURCE ,C=CARD, 
S=CONSOLE,N=NONE 

The operator must respond with one of the following: 

• C followed by END for SYSIPT 

• S followed by END for SYSLOG 

• N followed by END for the default option, EDIT. /lf~\ 

The default will be N END or just END, and the result will be the editing and ^.-.J' 

printing of the SYSREC file. If the operator response is C END or S END, the 
system awaits option data on either SYSIPT or SYSLOG. Enter CANCEL END 
if you wish to cancel the job at this time. 

If any response other than C, S, N, CANCEL, or END is entered: 

3E25I INVALID RESPONSE 
will appear on SYSLOG and message 3E1ID is reissued. 

Entering EREP options 

EREP options can be entered through SYSLOG or through SYSIPT. 

If you use the console printer-keyboard for input, you respond to the prompter 
messages. 

There can only be one option per line (SYLOG entry) or one option per card (card 
entry). Only one option card for each type of option (EDIT, CLEAR, SUM, HIST, 
TES, and SELECT) may be entered in an EREP run. However, when entered via 
SYSLOG, the SUM and SELECT options may be executed more than once in a 
single EREP run. Table F-3 lists the EREP options. 

You can alter the order of EREP actions by specifying two options. For example: 

OPTION EDIT Edit and print the SYSREC file. 

OPTION HIST Update the history tape, and then clear the file. 

*The END key on the Model 125 is replaced by the ENTER key 
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Job stream via 
SYSRDR 




3E11D ENTER OPTION SOURCE, C=CARD, 
S=CONSOLE, N=NONE 



When RMS=NO 

Run EREP only when hardware 
failures are detected on channel 
attached input/output devices, 
magnetic tape units and TP. 
Use MAINTENANCE LOG 
ANALYSIS to display hardware 
failures. F-5-F. 



F-3-F 



Enter C 
Press End 



Select option 
Enter S 
Press End 



Enter N 
Press End 



System waits for EREP options 
to be entered, for details see F-5 







Options entered 
via SYSIPT 




Options entered 
via SYS LOG 




Default option EDIT 

selected. 

Refer to table F-3-D 



Yes 



Refer to table F-3-A 



Yes 



3E05A ENTER SUMMARY PARAMETERS 
Refer to table F-3-B 



Yes 



3E03A ENTER SELECT PARAMETERS 
Refer to table F-3-E. 



Option EDIT, CLEAR, 
RDESUM, or HIST. 
Refer to table F-3-D 
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E R EP For input from either SYSIPT or SYSLOG, embedded blanks within the operation, 

option, or parameter are not allowed. Misspelled words, syntax errors, duplicate 
option statements and unsupported options are invalid. 

When input is from SYSIPT, these errors will cause 40 bytes of the card to be 
issued to SYSLOG along with the message: 

3E04I INVALID PARAMETER 

or 

3E12D INVALID OPTION 

At this time, you may place a corrected card in SYSIPT and then press END to 
process the desired option. If you do not want to process the card in error, enter 
END and the program will ignore that option card. However, if you wish to cancel 
the job, enter CANCEL END and the EREP job will be canceled. Multiple options 
are allowed by EREP. See figure F-3-D for a summary of the EREP options. 

Entering options via SYSLOG: When the EREP options are entered via SYSLOG, 
it is possible to execute the SUM and SELECT options more than once during an 
EREP run. After the SUM or SELECT function has executed, the message 

3E03A ENTER SELECT PARAMETERS 

or 

3E05A ENTER SUMMARY PARAMETERS 

is issued to SYSLOG. You may execute the SUM or SELECT function again by 
entering parameters at this time. If you wish to terminate the SUM or SELECT 
option, press END. \^ 

When entering the EREP option via SYSLOG, the entry must not exceed 80 
positions. Enter, in this sequence: 

1. The operation, OPTION 

2. A blank 

3. The option. 

Any parameters should follow the OPTION statement on the next line(s). Repeat 
this procedure for each option; when all options have been specified, enter END to 
continue processing. 

Note: The END key on the Model 125 is replaced by the ENTER key. 



c 
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Entering options via SYSIPT: When entering the EREP options via SYSIPT, EREP 

column 1 must be blank and only one option per card is allowed (for example, 
HIST with UPNEW or with NEW and/or 2 is considered one option). Each option 
may only be entered once for each execution of the EREP program. 

Example job streams for executing EREP: 

//JOB EXAMPLE1 

//TLBL EREPNEW 

//TLBLTAPEIN 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

//EXEC EREP 

OPTION HIST, NEW 
OPTION TES,TAPE,NEW 

/* 

/& 

// JOB EXAMPLE2 

//TLBLTESUP 

//TLBL EREPUP 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

// EXEC EREP 
OPTION EDIT 
OPTION TESJAPE 
OPTION HIST 

/* 

/& 
EREPNEW and EREPUP must be the filenames for new history files or for 
updating. TAPEIN and TESUP must be the file names for a new TES history tape 
or an update TES history tape. 
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An example of an EREP output obtained after a storage failure. 

The programmer's marks indicate the areas of interest. 

Note: the entry CONTROL WORD ADDRESS is not applicable for the Model 125. 
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When to use E REP EREP 

Your IBM customer engineer will usually advise you when an EREP printout is 
required, and tell you which option to select. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message OTl IW in the DOS /VS Messages manual will request you to 
RUN EREP. 

Other DOS/VS messages that request you to RUN EREP are issued, for example, 
in the following cases: 

• When the first record on the last track of the recorder file is reached, run 
EREP to avoid the risk of losing statistics. 

• When an unrecoverable I/O error on the recorder file occurs while the 
record indicated is being accessed, the record is ignored and processing 
continues. If this error persists, run EREP to retrieve the information from 
the file and recreate the file using different disk extents. 

• When SYSREC becomes full, no further recording occurs until the file is 
purged. To avoid the risk of losing statistics, run EREP. No recycling of the 
file occurs. 

• For system termination situations (for example, a machine check was 
unrecoverable, the channel caused system reset, or two channels are 
damaged) encountered by MCAR/CCH, recording is attempted. Depending 
on the success of recording, the execution of EREP is requested. An attempt 
is made to write a message to the operator. If the attempt is unsuccessful, 
the message code is in low main storage. 

• If the recorder file is more than 90% full at IPL time, the operator is requested 
to run EREP to prevent the loss of pertinent hardware data. 

Another occasion when you may choose to execute the EREP program is when you 
suspect that a hardware error is causing program errors. From the EREP printout 
you are able to detect any hardware failure and inform your IBM customer 
engineer of it. 




If 
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SEREP 

(MODEL 135, 145 or 155-11; 



SEREP is a self-loading, stand-alone program used to: 

1. Write the logout from real storage to some storage device such as tape for later 
use by the IBM CE 

2. Perform a hard-copy Edit/Print of the logout. 



When to use 

SEREP is primarily an aid provided for the IBM CE to help his offline diagnosis 
of hardv^are failures. For this reason SEREP need only be executed on the advice 
of the IBM CE or when requested to do so by a message on SYSLOG, or when a hard 
wait occurs and byte 1 of low real storage contains S (X'E2'). 

Flowcharts in Section 3 indicate when to use SEREP during IPL errors or if the 
system enters a hard wait state. 



Not applicable to the Models 115 and 125. 
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Start 



Before executing ensure 
that there is no system 
activity. 




Yes 



Press 

SYSTEM RESET 



1 



See next page 



Set CHECK CONTROL to 
STOP AFTER LOG 



Press START and wait 
until CPU stops 







Yes 



Punch 3-character address 
(for example, 'OOD') of re- 
quired output device in cols. 
67, 68, and 69 of last TXT 
card (next to last card in 

SEREP d eck) 

-* 



Enter SEREPdeck 

into card reader and load 

SEREP using IPL procedure 




1 



To retry, press RESTART 
I 



When edit is complete, 
write date and time on first 
page of logout 



Re-IPLif job 
processing is 
to be attempted. 



■ J 



The procedure for executing the SEREP program. 



SEREP 
(MODEL 135, 145 or 155-11) 



Wait state while executing SEREP 

Normal Waits 

When no output device is specified, or the specified device 
is not ready, the system enters the wait state after loading 
SEREP 

Hard Waits 

An unexpected program check during execution of SEREP 
causes a message to be printed, and the system enters the 
wait state. Retry is attempted by pressing RESTART. Re- 
IPL should be avoided because alteration of PSWs by the 
SEREP program may cause that edit to be erroneous. 

Termination 

When logout is complete, a message is issued and the system 
enters the wait state. If no log is found, a message is issued 
and the system enters the wait state 



F-4-F 



Avoid new IPL procedure. Because SEREP 
might have altered its PSW by this time, a 
re-IPL can cause part of edit to be wrong 

The only possible operator intervention that 
may be required would be for mounting the 
accumulation tape when the program asks for it. 
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(MODEL 158) 



Unlike the Models 135, 145, and 155-11, the Model 158 has no CPU logout area 
in real storage. Instead of being recorded in that area, certain types of hardware 
errors are recorded on the Log Recording Console File. The SEREP program also 
resides on the console file and can be loaded through its own IMPL procedure by 
using the MANUAL, SERVICE and INDEX frames. When SEREP is loaded, the 
SEREP frame is displayed to enable you to select one of the options. The options 
include: 

• Write the log to tape 

• Edit and print the log 

• Select and process one of eight previous logs. 

How to execute (Edit and print option) 

1 . Press STOP followed by MODE SEL 
The manual frame will be displayed 

2. Type in F2 or press light pen to lozenge ■ SERVICE FRAME 

(If a "hard copy" of the service frame is required on the 3213 printer, press 
COPY key or press light pen to lozenge ■ COPY) 
The service frame will be displayed. 

3. Type in F4 or press light pen to lozenge ■ 4-INDEX FRAME 
The index frame will be displayed as shown below. 

(Using COPY will not generate a hard copy of this frame.) 



Km^ 



7-CTRL STORE DISPLAY 
8-COMMOIM CH DISPLAY 



9-CHANNELO DISPLAY 
10-CHANNEL 1 DISPLAY 



11-CHAI\II\IEL 2 DISPLAY 
12-CHAIMI\IEL 3 DISPLAY 



13-CHAI\II\IEL 4 DISPLAY 
14-CHAIMNEL 5 DISPLAY 



15-SCU DATA FL0W1 
16-SCUDATA FL0W2 



17-CHAI\1I\IEL TO CHANNEL 
18-EXECUTION ARRAY 



20-CSBAR BKUPS 



COMPOSE- "START "STOP "CLE, 



21-CPU CHECKS&RETRY 



23-CHAI\)NEL CHECKS1 
24-CHANNEL CHECKS2 



28-EXTERNAL DIAGNOSTICS 



,..,^ 
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How to execute 



continued 



4. Type in F28 or press light pen to lozenge 

■ 28-EXTERNAL DIAGNOSTICS 
The frame shown below will be displayed. 
( Using COPY will not generate a hard copy of this frame.) 
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(MODEL 158) 



DIAGNOSTIC DISK 



0005534530 0000264E 



r FIRE THIS LOZENGE TO LOAD AND EXECUTE SEREP 

ITO PROCESS A PREVIOUS LOG FIRE THIS LOZENGE UNTIL - TRACK SELECTED - 



TO SELECT ABOVE OPTIONS WITH KBD-PRESS REQUEST, POSITION ARROW, PRESS ENTER 



SERVICE FRAME INDEX 







5. Press light pen to the lower lozenge until number 08 is displayed at the 
position of the two XX in the example shown above. 

6. Press light pen to upper lozenge on the display 
The program frame will be displayed. 

7. Press REQ key 

8. Respond to messages displayed as shown in the hard copy example below. 



158 SEREP, MACHINE CHECK SUMMARY DESIRED? REPLY YES OR NO 



/lACHINE CHECK SUMMARY: 



READY FOR LOG DUMP TO TAPE PORTION OF PROGRAM 
REPLY PROCEED OR CANCEL 



READY FOR EDIT/PRINT OF LOGOUT 
REPLY PROCEED OR CANCEL 



ENTER PRINTER ADR XXX 



END OF SEREP EXECUTION 



(The operators responses are shown in lower case characters.) 

The SEREP frame will be "rolled" onto the display as responses are given. After 

the address of the printer to be used as output device is entered, SEREP output 

will be observed on that printer. 

Note: The output device can be a tape unit, or the console printer. 
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Hardware Error Recording and Recovery 



LOG ANALYSIS 
(MODELS 115 AND 125) 



The LOG ANALYSIS facility allows the operator to display statistical data about 
hardware failures that are logged on the DISKETTE. 

The type and amount of detail displayed is selected by entering appropriate 
mnemonics into the MAINTENANCE PROGRAM SELECTION display. The 
sequence of displays is designed to guide the operator from the initial type of 
display selected to displays that provide more detailed data. 

For an interpretation of the data displayed refer to the Central Test Manual. 

The example shown on the opposite page illustrates the sequence of displays 
obtained to display the errors logged by the IPU (Instruction Processor Unit). 






When to use 

Your IBM customer engineer will usually advise you when to use this feature, and 
tell you which display to select. He may require a hard copy for offline analysis 
of all the displays selected, therefore save the hard copy output. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message .OTl IW in the DOS/ VS Messages manual will request you 
to RUN EREP. 

For the Models 115 and 125 you should only run EREP when requested to by a 
DOS/VS message. For example when the recorder file is fuU a message will be 
displayed informing you of this and re questing you to run EREP. Otherwise, before 
running EREP you should first contact your IBM customer engineer, who will then 
advise you on further action as mentioned in the previous paragraph. 



How to use 

To obtain the LOG ANALYSIS display required using fast selection, 

1 . Press the MODE SELECT key. 

2. Type in M followed by the associated mnenornics of the analysis to be displayed. 

3. Press the ENTER key. 

By selecting and entering the appropriate mnenomics, the operator can display 
logged errors for a particular input/output device or a particular part of the CPU. 



U J 
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Press MODE SELECT 



LOG ANALYSIS 
[MODELS 115 AND 125) 



MODE SELECTION 



R SYSTEM RESET 

C ADDRESS COMPARE 

L PROGRAM LOAD 

T INTERVAL TIMER 

K CHECK-CONTROL 

D STORAGE DUMP 

E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 



Enter M and press ENTER 



MAINTENANCE PROGRAM SELECTION 



LL 


lU 


TESTS 


CE-MAN.CPS 


A = 


= LOG GENERAL 


J =CPU 


S =IOP 


B = 


= CPU 


K = 1403 


U = CRT-SCOPE 


C = 


= CARD/PRINT I/O 


L = 2560/5425 


V = l/OEXERS 


D = 


= DISK 


M = 3504/3525 


X = IPU 


E = 


= ICA 


N = DISK 


Y = MATRIX S 


1 = 


= CHANG. DISKETTE 


0=ICA 


Z = MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 






Enter B and press ENTER 




CPU LOG ANALYSIS PROGRAMS 



B = SVP BUS-0 LOG 

C = IPU ANALYSIS I 

D = IPU LOG DISPLAY | 

E = MSC ANALYSIS | 

F = MSC LOG DISPLAY i 

G = lOP 8-F ANALYSIS 

H = lOP 8-F LOG DISPLAY 

PROGRAM SELECTION: MB 

):C003 M:X.DA00.4C. 



K = MTA LOG DISPLAY 

L = MSCI LOG ANALYSIS 

M = MSCI LOG DISPLAY 

N = MPX ANALYSIS 

O = MPX LOG DISPLAY; 



Enter C and press ENTER 



CARD/PRINT I/O LOG DISPLAY PROGRAMS 



3504 LOG DISPLAY H= 5425 LOG DISPLAY 



D= 3525 LOG DISPLAY K= 1403 LOG DISPLAY 



F= 2560 LOG DISPLAY M= 5203 LOG DISPLAY 



PROGRAM SELECTION: MC 



o 



Displaying the IPU Lx)g Analysis 
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DISPLAY FRAMES 
(MODEL 158 ONLY) 



This facility enables an operator to display information about hardware failures and 
warn the shift manager of IBM CE immediately about the nature and possible cause 
of the failure. 



Recognizing a hardware failure 

A hardware failure is indicated by a message which 'flashes' on and off at the lower 
right hand corner of the program frame or manual. 

The example below shows a hardware failure indicated by the words STOR CHECK 
on the manual frame. 




After recognizing the failure an operator is able to 'scan' the display frames and thus 
obtain detailed information about the condition of the hardware. This information 
may enable the IBM CE to diagnose the failure immediately and advise on continued 
system operation. He may also advise that the SEREP is executed and request 'hard 
copies' of the display frame on which the failure is indicated to enable an offline 
diagnosis of the failure. 






How to use 

From the program frame: 

1. Press MODE SEL 

The manual frame is displayed 

2. Type in F2, or press light pen to lozenge ■ SERVICE FRAME 
The service frame will be displayed 

3. Type in F4, or press light pen to lozenge ■ INDEX FRAME 

The index frame will be displayed, an example of which is shown in Section 1. 

4. Press light pen to lozenge - CPU DISPLAY 

The first display frame will be displayed, an example of which is shown at the 
top of the opposite page. 
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How to use 
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Hardware Error Recording and Recovery 

DISPLAY FRAMES 
(MODEL 158 ONLY) 





5. Scan the frame for any characters that flash on and off beside an entry displayed. 
For example, Z-BUS 614250 indicates that the hardware failure is caused by a 
faUure in the Z-BUS. 

If a hardware failure is indicated, press COPY to obtain a hard copy of that 
frame and make a note on the hard copy about the error. (Characters that 
indicate an error are not copied by the system.) 

6. Press the key marked f on the keyboard, as illustrated below. 
The next display frame will be displayed. 



CNCL 


1 


< 

2 


3 


4 


% 
5 


t 

6 


> 

7 


8 


( 
9 


) 



+ 

& 




START 


STOP 




H 


Q 


W 


E 


R 


T 


Y 


U. 


1 





p 


@ 


f 




MODE 
SEL 


IRPT 




REQ 


LOCK 


A 


S 


D 


F 


G 


H 


J 


K L 


' 1 


i 


, t 




i 


< 


1 


/ 


~\ 




COPV 


SHIFT 


Z 


X 


C 


V 


B 


N 


M 


1 


— 1 


? 

/ 


SHIFT 












KEYBD 
RESET 








ENTER 







7 . Repeat steps 5 and 6 until all display frames have been scanned and hard copies 
made of those containing information about the failure. 

8. Press CANL to obtain the program frame. 



When to use 

1. After recognizing a hardware failure as shown in the example above. 

2. On advice from your IBM CE. 
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OLTEP 






IBM provides a set of device test programs that run under control of DOS/VS. 
These test programs and the onUne test executive program form the onUne test 
system. The OnHne Test Executive program (OLTEP) is an interface between the 
system and the onUne test programs (OLTs) and communicates with the operator 
during the running of tests. 

Some uses: 

• Diagnosing I/O errors 

• Verifying I/O device repairs and engineering changes 

• Checking I/O devices. 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does 
not support the RMSR 
function. 



Some features: 




Multiple device testing 




Data security 




Data protection 




No re-IPL time required 




Prompting 




ASCII data conversion 




Accessing of error recording information 




CDS Equate function. 



OLT 



OLTEP 



Printer 



OPERATOR 



Supervisor 



Card 
Read/Punch 




■NK 



Teleprocessing 




OLTEP-System Relationship 



/^^ 
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Hardware Error Recording and Recovery 

Description and Operation OLTEP 

OLTEP operates much like other problem programs in DOS/VS. It is cataloged into 
the core image library and called by standard job control statements. When OLTEP 
is called, it notifies the operator that it is active and it communicates with him 
during testing. OLTEP can run in a batch-only system or as a background program 
in a multiprogramming environment. OLTEP must be run in the background 
partition in real mode and requires at least 14K. 

You can test an I/O unit with minimum interference to other programs running 
on the system. Testing an I/O device ordinarily does not interfere with system 
input and output. Any unit being tested (except for direct access devices) must not 
be assigned to the foreground partitions. Direct access devices, however, may be 
shared. 

An OLTEP user language defines and controls the test. With this language, you 
select the devices to test, the test sections to run, and the options to exercise. You 
enter this information via the console device or in the form of a control statement 
in the job input stream. This information is referred to as the test-run definition, 
which is common to OLTEP components for all operating systems. 

You can test multiple devices of the same type with no operator interventions 
other than those required for data protection and data security. OLTEP loads and 
executes the test sections one at a time until all the tests for one device are 
completed. If requested, the test sections then repeat for the next available device. 
Testing continues in this manner until all units in the test-run definition are tested. 

During testing under control of OLTEP, the system error recovery procedures are 
bypassed for the device being tested. OLTEP has built-in data integrity safeguards 
so that no data is destroyed without operator permission, and no protected data 
is accessed during testing. 
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DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 3 



DEBUGGING FOR THE 
OPERATOR 



3.1 



Pageof GC33-5380-1, 
revised September 30, 1974 
by TNL GN3 3-8793 



Section 3 



DEBUGGING 
PROCEDURES 
FOR OPERATORS 



How to Use 

This section is in the form of flowcharts that help the operator in the initial 
isolation of and possible recovery from errors that occur during system operation. 

• Each flowchart deals with a specific type of malfunction. 

• Pointers to operator's flowcharts in Section 2 (that must be followed to 
complete a procedure in this section) are referenced by the page tabs 
used in Section 2. 

For example: 



Execute a stand 
alone dump 
A-3-F 



Key to references: 



X-X-F 



Page tab 
of Section 2 

Flowchart 



o 



• When immediate recovery is not possible, offline program debugging is 
indicated. 



Operator's Flowcharts 

Error during IPL 
Initial system checks 
System in WAIT STATE 
Unintended LOOP 
Obviously incorrect output 
Job canceled by system 



Chart 01, parts 1 through 9 3.5 

Chart 02 3.15 

Chart 03, parts 1 through 4 3.16 

Chart 04, parts 1 through 6 3.22 

Chart 05.. 3.28 

Chart 06 3.29 
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Section 3 

WAIT STATE CODES 






BYTEO 


BYTE 1 


BYTE 2 


BYTE 3* 


EXPLANATION 


IPL Error Messages placed in Low Address Storage 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem programs. Check 
that the correct disk volume is mounted on the device assigned to SYSRES, and re-IPL. 
If the error recurs, the system programmer must check the allocations of real partitions 
specified in the supervisor to be used, and check that at least 16K of real storage is 
available for execution of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FV 


If a card reader has been assigned to SYSRDR during system generation and is to be the IPL 
communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation and yet it is 
to be the IPL communication device, simply READY the reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested cannot be found. 

Check that the correct disk volume is mounted on the device assigned to SYSRES. If it is 
correct, re-IPL and specify a different supervisor when message 0I03A is issued and press the 
END/ENTER key, or press END/ENTER key only, to load the standard supervisor. (If 
possible contact the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FV 
X'F2' 


X'FO' 
X'F8' 


Refer to messages 01 100A - 0128A in DOSA/S Messages. 


iMCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 

X'C2' 
X'C3' 
X'C4' 
X'C5' 
X'C6' 

X'C7' 
X'C8' 
X'C9' 
X'DI' 
X'07' 


X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 

X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'{2) 
X'E6' 


A, l,S(1) 
Not used 
A, l,S(1) 
A, l,S(1) 
A, l,S(1) 
A, l,S(1) 

A, l,S(1) 
A, l,S(1) 
A, l,S(1) 
A, I.Sd) 
Channel 


Not used 
Not used 
Not used 
Not used 
Not used 
Not used 

Not used 
Not used 
Not used 
Not used 
Unit or 
X'OO' 


Irrecoverable machine check. 

Irrecoverable channel failure during RMS fetch. 

Channel failure on SYSLOG when RMS message scheduled. 

No ECSW stored. 

Channel failure: ERPBs exhausted. 

Channel failure; two channels damaged or a damaged channel situation occurred while RMS 

was executing an I/O operation. 

Channel failure; system reset was presented by a channel. 

Channel failure; system codes in ECSW are invalid. 

Channel failure; channel address invalid. 

Irrecoverable channel failure on SYSVIS. 

IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 

Channel and unit indicate whether device in error is SYSRES or communication device. 

When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 

issued. Re-IPL system. 



Notes: 1. A (X'CV) =S YSR EC recording unsuccessful. 
I (X'C9') = S YSR EC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1 . WAIT STATE coded messages, part 1 of 2. 
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Sections 

WAIT STATE CODES 



BYTEO 


BYTE 1 


BYTE 2 


BYTES 




SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-I PL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO'O) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folk 


3wing Har 


d Wait Cod 


es are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


XF6' 


$MAINDR canceled during system CIL update. If this occurs, the system CIL is only 
partially updated and must be restored before use. This hard wait condition can also occur 
if the FETCH QUEUE BIT (FCHQ) is set in the linkage control byte in the partition 
communication region owned by the terminating partition. 


Device E 


rror Reco 


very Wait C 


odes place 


d in low address storage. 


X'08' to 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



'^ 



Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1. WAIT STATE coded messages, part 2 oil. 
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Start 



Error during IPL 

CHART 01, PART 1 



Ensure that you have set the correct 
address for the device to be used as 
SYSRES, and check that the correct 
SYSRES pack is mounted. 



Ensure the word TEST is not di played 
or the TEST indicator is not 'ON'. 
If it is, establish the reason through 
your shift manager or IBIVl CE. 




System CHECK indicators 
are explained in the 
OPERATING PROCEDURES 
manual for your Model of System/370 



Yes 



c 



Inform IBM 
immediately 



3 



Which of the following did you do after LOAD? 



Ready a 
card reader 



Press 
EXT INT 






Supervisor required 
must be specified in 
first card read 



or 



Press 
REQUEST 




No 



Supervisor 1 selected 
by default 



Specify the supervisor 
required 



Hard wait message 
See Table 3-1 



Which of the following did you do next? 



Ready a 
card reader 



or 
I 



Press 
EXT INT 



IPL communication 
device is the card reader 
made ready 



or 
I 



Press 
REQUEST 



IPL communication device 
is the card reader assigned 
during system generation 



IPL communication 
device is SYS LOG 



o 



To part 5 



To part 2 
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Error during IPL 

CHART 01, PART 2 



From part 1 



^ 



0110AGIVE IPL CONTROL COMMANDS 



For example: 

01151 PUB ALREADY EXISTS 




No 



To part 3 



Yes 



Complete operator action > 
under appropriate message 
number in DOS/VS Messages j 



See D-1-F For iVlodels 135, 145, 11 
and D-2-F for Models 1 1 5, 1 25 
and D-3-Ffor Model 158 



Dump, or display and note the 

• Current PSW 

• 16 Control registers 

• 16 general registers 

• Low address storage 



o 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3. 




Yes 



^Complete operator/programmer \ 
taction. See Table 3-1 . J 



To part 8 



\j 



3.6 Debugging for Operators. 



Error during IPL 
CHART 01, PART 3 



From part 2 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for IVlodels 115, 125 
and D-3-F for Model 158 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 



01201 DOS/VS IPL COMPLETE 







Yes 



ner \ 



/ Complete operator/programmer 
\ action. See Table 3-1 on page 3.3 ^ 



Yes 



Proceed with normal job 
processing 



Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 



Re-IPL 




To part 4 
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Error during IPL 
CHART 01, PART 4 



From part 3 



01201 DOS/VS IPL COMPLETE 




Yes 



No 



Use the reserve (backup) 
SYSRESpack 



Re-IPL 



01201 DOS/VS IPL COMPLETE 




Yes 



Is it the first IPL for 
a newly assembled 
supervisor? 



Save notes about your 

problem and actions, 

and inform your shift manager. 



No 




Proceed with normal 
job processing 



3 o 



Yes 



See D-1-F for Models 135, 145, 155-1 1 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 158 



No 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



Execute a stand- 
alone dump. 
A-3-F. 



For programmer action 
see section 4 (Chart 01 ) 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Inform IBM of 
your problem 



O 



3.8 Debugging for Programmers 



Error during IPL 
CHART 01, PART 5 



From part 1 




No 



See D-1 -F for Models 1 35, 145, 1 55-1 1 i 
and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 158 



The first character of a message 
originated by IPL is a 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 




To part 6 







Yes 



Put SYSRES on a different drive, and if 
possible, select a different channel. 
(Do not forget to set the new 
address for SYSRES.) 



Complete operator action under 
appropriate message number in 
DOS/VS Messages 



01201 DOS/VS IPL COMPLETE 




Yes 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 115, 125 
and D-3-F for Model 1 58 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 



Proceed with normal job 
processing 




To part 8 
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Error during IPL 

CHART 01, PART 6 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 1 15, 125 
and D-3-F for Model 158 

Coded messages stored in bytes t 
0-3 of low address storage are ' 
listed in Table 3-1 on page 3.3 



01201 DOS/VS IPL COMPLETE 



01201 DOS/VS IPL COMPLETE 



From part 5 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 




Put SYSRES on a different drive, 

and if possible, select a different 

channel. 

(Do not forget to set the new 

address for SYSRES.) 




Use the reserve (backup) 
SYSRES pack 



Re-IPL 




Yes 



Complete operator action ^ 
under appropriate message 
number in DOS/VS Messages . 



Yes 



I Proceed with normal processing 1 



o 



Yes 



Save notes about your problem 
and actions, and inform your 
■shift manager 



( Proceed with normal 'processing 






To part 7 






3.10 Debugging for Operators. 



o 



01201 DOS/VS IPL COMPLETE 



01201 DOS/VS IPL COMPLETE 



#*%, 
^^' 



Is it the first IPL for 
a newly assembled 
supervisor? 



^*| 

^^||' 



From part 6_ 




Yes 



No 



Use new IPL control cards 



Re-IPL 




No 




No 



Execute a stand-alone 
dump. 

A-3-F. 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Yes 



Yes 



Inform IBM of 
your problem 



Error during IPL 
CHART 01, PART 7 



Save notes about your 
problem and actions and 
inform your shift manager 



Proceed with normal 
job processing. 



Execute a stand-alone 
dump. 

A-3-F. 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



3 C 



For programmer action 
see Section 4 (Chart 01 ) 
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Error during IPL 
CHART 01, PART 8 



From part 2 




Re-IPL 




Yes 



Proceed with normal 
job processing 



From part 5 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 145, 155-11 
and D-2-F for Models 115, 125 
and D-3-F for Model 158 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 on page 3.3 




Yes 



No 



Execute a stand- 
alone dump. 
A-3-F 






If possible, use a different 
device as IPL communication 
device. 



Use reserve SYSRES pack, 
and if communication 
device is SYSRDR, use a 
new IPL control card deck. 



Re-IPL 




Re-IPL 



Yes 



Re-IPL 



No 





To part 9 



A 
To part 5 




To part 9 



o 



3.12 Debugging for Operators 



Error during IPL 

CHART 01, PART 9 



From part 8 



From part 8 




01201 DOS/VS IPL COMPLETE 




Yes 



No 




Proceed with normal 
job processing 



Execute a stand 
alone dump. 
A-3-F 






Inform your shift 
manager of your 
problem 



No 




Is it the first IPL for 
a newly assembled 
supervisor? 



Yes 



Execute SEREP 
(Refer to F-4-F for 
Models 135, 145, and 
155-1 Dor 
Display log analysis 
(Refer to F-5-forthe 
Models 115 and 125 or 
F-6forthe Model 158) 



Save the low address 
storage dump, the stand- 
alone dump, and the 
SEREP printout for IBM. 



Save the notes about 
your problem and 
actions, and inform your 
system programmer. 



Rebuild SYSRES. 

Save the original SYSRES. 

Save the low address 

storage dump. 

Save the stand-alone dump. 

Inform IBM of your 

problem. 



o 



Inform IBM of 
your problem 



For programmer action 
see Section 4 (chart 01 ) 



Proceed with normal 
job processing 
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Initial System Checks 
NOTES FOR CHART 02 



r 



Note 1 < 



Note 2 < 



Recognizing a wait state 

Any of the following observations confirm that the system is in a Wait State: 

• WAIT indicator remains on, or on the Models 1 15 and 125 the word WAIT 
remains displayed on the video display unit 

• SYS indicator remains off (Not applicable to the Models 1 15 and 125). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators on. 

• A HARD MA CHINE CHECK message is issued on SYSL OG or a 
coded "wait state" message may be contained in bytes 0-3 of 
low address storage or in GR II (X'B') 

Recognizing a loop 

One or more of the following occurrences may indicate that a job /program is in 
an unintended loop: 

• A steady glow in the light of the system control panel with the SYS indicator 
on. For the Models 1 15 and 125, the word WAIT may flicker on the video 
display unit. (This depends on the size and nature of the loop.) 

• A rhythmic pattern in the lights of the system control panel, or, for the 
Models 1 15 and 125, the word WAIT may flicker on the video display unit. 

• A pointless recurrence of I/O activity. 

• A job/program that does not change status for a long time. This may result, 
for example, in an absence of I/O activity with both SYS and WAIT 
indicators on. 

A note to the operator: When a loop is recognized, first try to contact the 
programmer before beginning any debugging procedures. If this is not possible, 
follow the instructions in chart 04. 



M 



r 



Note 3 < 



Note 4 < 



V, 



Recognizing incorrect output 

Incorrect output during system operation may be recognized by any one of 
the following: 

A. Duplicate output 

Output of identical data or more output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 

B. Invalid or unidentified output 

Printed (or displayed) output that is obviously incorrect on: 

• line printer 

• console printer 

• video display unit. 

C. Lack of output 

No output when there should be,or less output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 

Job/program canceled by system 

The system's canceling of Job is normally caused by a Program Check Interrupt 
that is recognized by a message, for example: 

BG 0S031 PROGRAM CHECK INTERRUPTION - HEX LOCATION 0610F8 
CONDITION CODE 2 - SPECIFICATION EXCEPTION 
OSOOUOB NO NAME CANCELED 

The program is automatically canceled by the supervisor and depending on the 
use of the job control statement, // OPTION DUMP, a dump of the partition 
and supervisor is executed. 



J 



o 
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- Check 1 

Message on 
SYSLOG 



- Check 2 

Output from 
job/program 
(See note 3) 



Initial System Checks 

CHART 02 



Did you understand the message and respond to 

it correctly? If no message was printed, go to check 2. 



Yes 



Save SYSLOG 
output, and go to 
check 2. 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Is there unscheduled output? 

Is scheduled output not as expected? 



Yes 



No 



Save the output, 
and go to, check 3 



Make a note, and 
go to check 3. 



- Check 3 

Input/output 
devices. 



jr\ 



- Check 4 — i 

Input/output 
media 



- Check 5 — 

Program change 
during run 



- Check 6 

Programmer's 
instructions 



Are the assigned devices set up correctly? (e.g. bits per inch) 



N 



Have any of the assigned devices a malfunction 
condition? (Some examples of device malfunctions 
are listed in Section 1.) 



Are you using correct SYSRES pack? 

input files/volumes? 
work files/volumes? 
Input/output devices? 
teleprocessing lines? 



Have you altered the contents of any real or 
virtual address area since the job/program began 
running? 



Do you understand the programmer's 

instructions? 

(if in doubt, try to contact the programmer.) 



No 



Rerun or restart 
job/program. 



Yes 



Try to use a different 
device or consult the 
operating guide for the 
device, and inform your 
IBM customer engineer. 



No 



Go to check 4. 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Yes 



Go to check 5. 



Yes 



No 



Compare your notes 
of the alterations 
with the programmer's 
instructions. If there 
is a difference, try to 
contact the programmer 
before rerunning the job. 



Go to check 6. 



No 



Yes 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 7. 



- Check 7 

Operating 
procedures 



Are there any recent changes in the system 
operating procedures, and if so, do they affect 
this job? 

(If in doubt, contact your shift manager or 
senior operator.) 



Yes 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 8. 



o 



- Check 8 

Categorize the 
malfunction 




System in a WAIT STATE? (See note 1 ) 
LOOP? (See note 2) 

Obviously incorrect output? (See note 3) 
Job/program canceled by system? (See note 4) 



Turn to chart 03 
Turn to chart 04 



Turn to chart 05 
Turn to chart 06 
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Wait State 
CHART 03, PART 1 



Model-dependent 
control console 
layout 


a e H 


S®®@@(o)® 

BE) H oesBss Q 



Start 



1^ \ 

■ SVS MAN WAIT TEST LOAD ■ 

|o66qo| 



WAIT indicator ON 
SYS indicator OFF 



Yes 



f 




The TEST indicator is on when any of the following 
switches are not in the process or normal position. 

1. RATE 

2. CHECK CONTROL 

3. DIAGNOSTIC/CONSOLE FILE CONTROL 

4. ADDRESS COMPARE CONTROL 



No 



i 



The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a soft-stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 



I 



If SYSLOG is inoperative, a device error recovery message 
may have been printed on the line printer assigned as 
SYSLST. 

Example of a device error recovery message 



0P08A INTERV REQ SYSRDR=OOC 







Inform your shift leader or 
manager of the condition, 
and request time for 
hands-on debugging to 
gather system information. 



Consult DOS/VS 
Messages manual 




To part 2 of this chart 
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From part 1 of this chart 



Wait State 
CHART 03, PART 2 




AR 1I60A READY FOR COMMUNICATIONS. 



Yes 



Yes 



See D- 1 F for Models 1 35, 145, 1 55-1 1 
and D-5-F for Models 115. 125 
and D-6-F for Model 158 



Check that the last JCL 
assigning SYS LOG was a 
statement and not a 
command 



No 



No 



Dump or display low 
address storage. Use 
ALTER/DISPLAY 



Compare the contents of 
bytes 0-3 of low address 
storage with the list of 
wait state coded messages 
shown in table 3.3 on 
page 3.4 




Yes 




Yes 



Yes 



No 



Continued debugging using 
the flowchart shown in 
Section 2,E-3-F. 



SOFT WAIT 




To part 6 of this chart 



D 



To part 3 of this chart 
Debugging for Operators. 
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Wait State 

CHART 03, PART 3 



From part 2 of this chart 



Issue the MAP command. 
Refer to Section 2, E-1. 



Make each I/O device 
NOT READY, then 
READY in turn, checking 
for any I/O activity as 
this action is carried out. 



No 




Yes 




Does not apply to 
POWER/VS RJE tasks 



No 



Contact terminal (s) and 
request data to be 
entered 



Yes 




If an interrupt occurs, the CPU 
is taken out of the wait state,; and 
processing is started under control 
of the program being executed. 



No 



o 



To part 4 of this chart 
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From part 3 of this chart 



Wait State 
CHART 03, PART 4 



i 1Q12I POWER/VS INITIALIZATION COMPLETED 




To part 6 
of this chart 



Enter command 
PINQUIRE ALLto 
check status of 
RJE lineis) 



No 




Contact the terminal (s) 
showing inactive jobs 
and request environ- 
mental check and /or 
reason for not signing on 



To part 6 
of this chart 



To part 5 
of this chart 



To part 5 
of this chart 
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Wait State 

CHART 03, PART 5 



From Part 4 
of this chart 



From Part 4 
of this chart 



No 



Issue the command 
PDISPLAY RJE to 
obtain a status report 
of RJE queue entries 




Either wait for problem 
to be solved at terminal 
or issue the command 
PSTOP line address 
to cancel that RJE line. 



1R17I LINE HAS BEEN 
StOPPED 




Issue the following commands: 
PDISPLAY RDR,ALL 
PDISPLAY LST,ALL 
PDISPLAY PUN,ALL 
Then after the output, if any, 
use the PSTOP command to 
stop the tasks or partition(s) 
running under POWER/VS 




: 1Q33I STOPPED ttt,cuu 



Yes 



Issue the command 
PENDKILL,OOE 



System dump 
is described in 
section 2,A-2 




No 



W 



Yes 



Yes 



To part 6 of this chart 
3,20 Debugging for Operators 



Continue normal 
system operation 




System \ No 
operational 



\y 



To part 6 
of this chart 
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Wait State 
CHART 03, PART 6 



From part 2 of this chart 




Execute a stand 
alone dump 
A-3-F 






Execute SEREP (Refer to 
F-4-Ffor Models 135, 145, 
and 155-11) or Display log 
analysis (RjfetjQ_l^5^r 
t he Mo dels_ri5 and 125 or 
F-6 fo7Thn?iodelT58ir 



RE-IPL 



If the problem recurs, re-iPL 
and execute EREP (select 
default options) F - 3 - F 



Have the SEREP, EREP 
and stand-alone dump out- 
puts available for your IBM 
customer engineer 



HARDWARE ERROR 

Note: Certain unusual hardware and software failures can 
cause the system to halt processing with both the system 
light and the wait light on continuously. This indicates that 
the current PSW has its wait bit set on but the CPU is 
processing microprogram instructions. If possible, the 
system should be left in this state until a customer engineer 
has arrived. A stand-alone dump can show the I/O 
operations in process. 



From part 2 and 4 
of this chart. 



From part 5 
of this chart 




Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-iPLand obtain a 
dump or copy of the page data 
set as described in Section 2, C-6 



Re-IPL and obtain 
a dump or copy of 
the PDS, C-6 



Save the following system 
information fo the system 
programmer: 

• SYSLOG output including 
MAPandPINQUIRE 
command output 

• Line printer output, including 
the stand-alone dump output, 
the dump or copy of the 
page data set, and the 
POWER/VS system dump 

(if applicable) 

• If the stand alone dump 
was executed, a note of: 

Current PSW 

16 control registers 

16 general registers 

Low address storage 

X'OO'-'BF' 

• Job stream (if possible) 

• Note of system activity 

• Note of your actions 

• Input files/volumes 

• (if possible) 



OPERATIONAL 

OR 
PROGRAMMING ERROR 
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Unintended Loop 

CHART 04, PART 1 






Start 



Inform your shift leader or 
manager of the malfunction 
and request time for hands-on 
debugging to gather system 
information. If possible, 
check estimated job run 
times with the programmer(s) 



r 



From part 5 of this chart 



Press REQUEST 



Determine if 
loop is in "^ 

supervisor 



V. 



Yes 





AR 1I60A READY FOR COMMUNICATIONS 



NO 



Loop is probably 
in the supervisor. 



No 





A program or partition is time dependent when it uses 
one or any of the following I/O methods: MICR 
(Magnetic Ink Character Recognition), OCR 
(Optical Character Recognition), TP (Telepro- 
cessing) 



No 



No 



Yes 



No 



Yes 



TP suspected of causing loop 




MICR and/or OCR 
suspected of causing loop. 



3.22 



To part 2 of this chart. 
Debugging for Operators. 



B 

\/ 

To part 3 of this chart. 




o 




To part 4 of this chart. 



To part 4 of this chart. 
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From part 1 of this chart. 



Unintended Loop 

CHART 04, PART 2 



r 



Actions to prevent the 
following procedures 
affecting MICR/OCR. 




No 



Empty the hopper of the 
MICRand OCR devices 



< 



K. 



If the message 
INTERV REQ is issued on 
SYS LOG for the MICR 
and/or OCR devices, DO 
NOT READY these devices 



If possible consult your |" 
shift leader or manager 

before making this \ 

decision. ' 




No 



Execute the MAP 
command; refer to Section 
2, E-1. 




To part 5 of this chart. 



No 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits via CR 10 and 1 1 . 




No 



To part 6 of this chart. 



H 
To part 6 of this chart. 
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Unintended Loop 

CHART 04, PART 3 

From part 1 of this chart 



B 



,y 




Inform terminal (s) of 
malfunction condition 




No 



Yes 




No 



Yes 



No 



Partition using TP 
is causing loop 



No 




No 



Yes 



TP is causing loop 



Loop is in partition using TP 




Yes 




Yes 



Partition using TP 
is not causing loop 



Inform terminal (s) that there will be TIME-OUT and that program using TP 
may have to be restarted or re-run at some other time, because of 
hands-on debugging procedures 



No 



To part 4 of this chart 



A 



To part 2 of this chart 



No Loop; continue 
processing 



\^^ 



To part 4 of this 
chart 
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Unintended Loop 

CHART 04, PART 4 



From part 1 of this chart 



Press STOP on all 
MICR/OCR devices 




No 



From part 1 , or part 3 
of this chart. 



^^. 



Yes 



Loop involves operation 
on MICR/OCR 



Trace loop by instruction 
step method. 



, See D-4-F for Models 135, 145, 155-1 1 
■44-^ 'S' - and D-5-F for Models 1 1 5, 1 25 
' ''«-,and D-6-F for Model 158 

Note: 

It is important that at least 
15-20 instructions in the 
loop are noted. A trace of 
complete loop depends on 
time allowed for debugging. 






To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 5 



From part 2 of this chart 



r 



Pause all jobs to 
free a partition. 







Press REQUEST 



< 



\^ 



An EOJ is indicated by the SYS LOG message 

XX READY FOR COMMUNICATIONS 

(XX indicates the partition issuing the message). 



When Attention Routine 
is initiated (AR issued 
on SYS LOG), enter 
PAUSE BG, EOJ 
PAUSE F4, EOJ etc, to 
pause all partitions. 




No 



Yes 



Execute the MAP 
command; refer to Section 
2, E-1. 



Before proceeding, check 
estimated job run time, either 
by contacting the programmer 
or from program run sheet 




To part 1 of this chart 




No 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits via CR 10 and 1 1 . 




To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 6 



From part 5 of this chart. 



At this stage, if only one job has not reached 
EOJ, it is possible that this job is causing the 
loop. Checi< estimated job run time with 
programmer or on program run sheet 



From part 2 of this chart 




Yes 



More than one job still 
running 



1^ 




Let system continue 
processing. Programmer 
must immediately 
analyze the problem 



Yes 



Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPLand obtain a dump 
or copy of the page data set as 
described in Section 2, C-6. 



Turn to Section 4, 
Chart 01, Part 2 



Save the following for the 
programmer: 

• SYSLOG output 

• Line printer output 

• Job stream 

• I/O files/volumes 

• Loop trace (instruction 
step or SDAID output) 

• MAP, if applicable. 



I 



Re-IPL: initiate 
different jobs 



3 



Loop is probably caused 
by this job 



Trace loop either by 
instruction step (See 
note 1 ) or by using SDAID 
routines B-10-F (See 
note 2) 



From part 2 or 4 of this chart 



Note 1: 

See D-4-F for Models 135, 145, 155-11 
and D5-F for Models 1 15, 125 
and D-6F for Model 158 

Note 2: 

SDAID should be used 
only by system programmers 
or by IBM CE/SE. 
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Obviously Incorrect Output 

CHART 05 



Start 



The identity of the partition using the device: 

This can be deduced from information given on 

the job run shetet, or the device ASSGN statements 

and commands issued on SYSLOG and SYSLST. 

An alternative method is to make the device producing 

incorrect output NOT READY. This will cause a 

device error recovery message to be issued on SYSLOG. 

Determine the partition using the device from the 
message printed on SYSLOG as a result of this action. 



K possible, contact the programmer 
to establish the expected output, 
and identify which job or partition 
is using the device that is 
producing the incorrect output 



BG 



0P08A INTERV REQ SYS008 = 



383 



Partition identity 



I/O Device Address 



Make the device producing 
incorrect output NOT READY 



Press REQUEST and wait for 
message 0P60D, then enter 
IGNORE 



\J 



AR 1I60A READY FOR COMMUNICATIONS, 



If SYSLST for the partition to be dumped is not 
assigned to a line printer, use the line printer 
assigned as SYSLST on another partition. 
For example, DUMP F2S(BG). 
Note: This may produce dump output from the 
partition being dumped, interspersed with 
output from the program using the line printer. 



A System dump may be issued on the device assigned to 

SYSLST for the partition being canceled. 

(The System dump is described in Section 2, A-2.) 



Respond to the AR message 

by issuing the DUMP command 

to dump the partition and the 

supervisor, for example, DUMP F2S 

SYSLST must be assigned to a 

line printer. 

Refer to Section 2, A-1 



Cancel the job in the partition 
producing the incorrect output 



Save the following information 
for the programmer (s). 

• SYSLOG output 

• Line printer output, including 
all dump output 

• Job stream 

• I/O files/volumes 
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Program Canceled 

CHART 06 



\ 



Start 



An informative message 
is issued on SYS LOG 
orSYSLST, orboth 



0P731 JOB DEBUGEX8 CANCELED DUE TO I/O ERROR 
0S071 PROBLEM PROGRAM PSW 031 0000000007 A02 



BG 0P24I C PROG CHECK SYS009=00D 

CCSW=001 000022800200000 CCB=007A0E 

SNS=0000000000000000000000000000000000000000000000001 
BG 0P73IJOB DEBUGEX8 CANCELED DUE TO I/O ERROR 







An example of a job cancellation 
message issued on SYSLST 



An example of a job cancellation 
message issued on SYS LOG 



If the message 1Q30D ABNORMAL 
POWER/VS TERMINATION 
PRINTER= is issued on SYSLOG 
the program check occurred in the 
POWER/VS partition. To obtain a 
dump, you must respond to the 
message and specify a line printer 
device address. 



J 



A system dump is issued 
to the device assigned as 
SYSLST 



A system dump is issued to SYSLST under the 

following conditions 

■ 1. The supervisor in use supports the OPTION DUMP, 
which is not overruled by the job control statement 
// OPTION NODUMP in the job stream. 

2. The job control statement // OPTION DUMP is 
included in the job stream. 

Note: If the program check occurred in a program 

running under POWER/VS, the dump will be output 

to the spooling device. 

For a complete description of the system dump, refer to 

Section 2, A -2. 



SYSLS 
assigned 
Jine prin 



5-r^ No 


Dump the di 


jk extent, or 

oc CVCI CT 


TO a ^ ^ 
ter/"'^ 


to obtain a printed dump 









Execute the 
MAP command 
(refer to section 
2, E-1) 



Save the following information 
for the programmer: 

• SYSLOG output 

• Line printer output, including 
any error messages and the 
system dump 

• Job stream 
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For your notes 



xJ' 



C 



3.30 Debugging for Operators. 



DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 4 






DEBUGGING FOR 
SYSTEM PROGRAMMERS 



O 



%J 



Section 4, DOS/VS Serviceability Aids and Debugging Procedures 

DEBUGGING 

PROCEDURES 

FOR SYSTEM 

PROGRAMMERS How to use 



The choice of serviceability aids and methods of off-line program debugging and of 
analyzing each programming error rests with the programmer. The flowcharts in 
this section, however, will help the programmer to choose the method best suited to 
the type of error. For efficient analysis of dumps, program output, and printouts, 
an understanding of DOS/VS information blocks and supervisor interface tables is 
required. This section describes how your programs, referred to as user programs, 
interface with the IBM System Control Programs (SCPs). It also illustrates the 
allocations of storage, program and supervisor save areas, and details the informa- 
tion contained in the interface tables useful for program debugging. 

The debugging of user programs written in a high-level language or for use with 
teleprocessing are not discussed. However, the serviceabiHty aids described in 
Section 2 and the operator procedures of Section 3 should be used initially to 
gather information from the system. Having obtained the information, the procedures 
in this Section can then be used inconjunction with the debugging procedures 
described in the applicable high l6vel language or teleprocessing component manuals. 

This Section is divided into two parts. The first part consists of checklists in the 
form of flowcharts that should be used as a guide during offline program debugging. 
They help in selecting a method of analysis, and if required, help in the choice of 
the serviceability aid for further error isolation. 

The second part of this section consists of a general description of the DOS/VS 
supervisor tables, information blocks, and save areas, together with other system 
information useful for offline debugging. More details about these tables and areas 
can be found in the IBM publication DO^/KS Supervisor Logic. 

Note: It is assumed that the programmer using this section is familiar with DOS/VS 
multiprogramming, asynchronous processing (multitasking), relocating load, virtual 
storage, and data management techniques. These techniques are described in the 
DOS/VS System Management Guide . 
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Start 



Program Error 
recognized by: 



Operator 
not able 
to IPL 



Operator during 
execution of 
job/progrann 



Error during IPL 



System entered 
a wait state 



Incorrect output 
detected at some 
time after running 
the job/program 



Turn to chart 07 
in this Section 



Unintended loop 
developed 



Program produced 
obviously incorrect 
output 



Job/program 
canceled 



The operator should supply this data gathered from the system when the error occurred 



SYSLOG output. 
Dump, or note of 
low address storage 
bytes X'OO'-X'BF' 
Stand-alone dump. 
SYSRESpackin use 
when error occurred. 



SYSLOG output. 
Dump, or note of low 
address storage & current 
PSW. 

Stand-alone dump. 
Dump or copy of SYSVIS. 
Any line printer output 
when error occured. 
Job stream. 

Note of Input/output files/ 
vols. SEREP/EREP output 
if applicable to cause 



SYSLOG output 

Partition dumps, if any 

taken. 

MAP of system. 

Job stream. 

Any line printer output 

when error occurred. 

Stand-alone dump. 

Dump or copy of SYSVIS 

Loop trace, either 

manual or SDAID. 



SYSLOG output 
Line printer output, 
including the dump 
of the partition using 
the device producing 
incorrect output. 
A dump of the 
supervisor, or a 
System dump. 
Job stream. 
All input/output files/ 
vols used by the 
partition dumped. 



SYSLOG output 
System dump (if 
executed). 
Any line printer 
output from Job, 
including any 
messages. 
Job stream. 






The application programmer should supply you with this data to aid problem analysis 



As the system programmer 

you may require: 
Supervisor listing 
of supervisor in use. 
Linkage editor map 
for the supervisor 
in use when terror 
occurred. 



Program listings of 
all programs being 
executed when error 
occurred. 

Linkage editor maps 
for the programs. 
Supervisor listing for 
supervisor in use. 



Program listing of the 
program in which 
loop developed. 
(If loop was not 
isolated to a partition, 
program listings of all 
programs being 
executed when loop 
occurred may be 
required.) 

Linkage editor map 
for program (s). 



Program listings. 
Linkage editor map. 



As the system programmer 
you may require: 

Program listings. 

Linkage editor map. 

Supervisor listing. 



Turn to chart 02 
in this Section 



To part 2 
of this chart 
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From part 1 
of this chart 



A 

Y 



Check 1 

Error messages 



I — Check 2 — i 

Program execution 



I — Check 3 — i 

Program, or module 
(sub-routine) coding 



O t 



Check 4 

Input media 



I — Check 5 

Input/output 
device and type 



- Check 6 - 

DOS/VS level of 
release 



Check? , 

Job control 
statements 



, — Check 8 — i 

System hardware 
configuration 



o 



, — Checks - 

Categorize error 




initial Checks 
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Look for messages on console printer log sheet, or 
line printer output associated with the job in error. 



Consult "Programmer Action" listed in 
DOS/VS Messages. If solution to 
problem not found, return to check 2. 



No 



Has the program ever run successfully? 



M 



Yes 



•/Has there been a reassembly of the program, or any 
module used by it, since the previous run? 

• Has the program or any module used by it been 
recataloged since previous run? (For example, 

a change in LOAD or ENTRY addresses.) 

• Has any coding been changed by REP or SOURCE 
cards? 

• Has an IBM programming temporary fix (PTF) 
been applied to the program, or any of its modules? 




• Has there been any change in the location of data 
on any of the input files? (For example, the area 
containing the data on a disk pack has been moved 
to another address either on the same pack, or on a 
different pack.) 

• Has there been a change in any input media? (For 
example, input data was previously on cards, but has 
since been transfered to disk pack.) 



Was a different physical input/output device type 
assigned? (For example, in the previous run, I/O 
device was a 3330 disk drive, but is now a tape unit.) 




• Did the program run previously under the same 
supervisor DOS/VS release? 

• Was the same supervisor used for both runs? 

• Have there been any changes to the supervisor, since 
the previous run? (For example, re-system generation) 



Has there been any real change in job control since 
previous run? (For example, a change in the // EXEC 
parameter to REAL from default.) 



Was the program executed on a different system 
configuration from the previous run? 
(For example, a different model of CPU.) 




■Program error recognized by: 
WAIT state 



LOOP 

Obvious incorrect output 
Job/program canceled 



Go to check 9 



Go to check 3 and continue through 
this checklist. It is recommended to make 
a copy of this chart and make notes 
(for future reference) in this column 
of any differences from previous 
execution of the program. 
At this stage there is no need for further 
action, unless the solution to the problem 
becomes obvious. 





Turn to chart 03 
Turn to chart 06 
Turn ot chart 08 
Turn to chart 09 
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4.3 



Intentionally Blank 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



— Check 1 

Supervisor listing 



if the IPL procedure can not be completed 
and the supervisor in use has never been used 
on the system, check the supervisor assembly 
listing for flagged statements. Also note in 
the listing the options supported by the 
supervisor. 

Check that the hardware is present in the 
system for options supported by the super- 
visor that require hardware support. 

Also check that the supervisor is generated 
to support hardware options that are present 
on the system. 



If the cause of the error can not be isolated, 
inform IBM and have the following informa- 
tion available: 

• The supervisor listing 

• The stand-alone dump output, including 
the dump of the low address storage 

• The SYSRES pack used when the error 
occurred 

• Any notes about actions taken during error 
analysis both on and offline. 



.^ 
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Hard Wait Message Codes 
SUPPORT FOR CHART 03 






BYTEO 


BYTE 1 


BYTE 2 


BYTES 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed 


in low address storage 


x'cr 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure on SYSLOG when RMS nnessage scheduled. 


X'C4' 


X'E2'(2) 


A, l,S(1) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, l,S{1) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, 1,8(1) 


Not used 


Channel failure; channel address invalid. 


X'DI' 


X'E2'(2) 


A, l,S(1) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 
Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-I PL system. 


SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62 


X'C5' 


Not used 


Not used 


SDAID output device became unready. Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'00'(3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The foil 


Dwing Hard Wait Codes are plac 


3d in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO,and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO' 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


Device E 


rror Recovery Soft Wait Codes 


placed in low address storage. 


X'08'to 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to OP messages in DOS/VS Messages. 



^%^ 



Notes: 1. A (X'CI') = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 



Refer to Section 2-E-3 for a list of IPL error message codes and a more detailed description of wait states. 



c 
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Check 



I — Check 1 

Eliminate components 



Check 2 

Type of Wait 
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Method of Analysis 



Hard Wait with Message in Low Address Storage 
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Recommendations to Aid 
Further Problem Analysis 



Was POWER/VS initiated when the wait state 

occurred. 

Establish this from the SYSLOG logsheet, 

or the operator concerned. 



Yes 



No 



HARD WAIT STATE 



SOFT WAIT STATE 
(You may require an interview with the 
operator to verify if this type of wait 
occurred, and request information about 
system occurrence and messages printed 
prior to the wait state.) 



Examine bytes 0—3 of low address storage 
noted by the operator and the contents of 
GPR 1 1,X'B' in the dump output. Compare 
the contents with the coded messages 
listed on the opposite page. 

• If the code is listed analyze the program 
further based on the reasons given against 
the codes in the list. 

• If the code is not listed, turn to chart 13. 



Go to check 2. 



Proceed to check 3. 



Turn to chart 05. 



XfcwV 



— Check 3 — 

Analyze message in 
low address storage 



Use the dump, or notes made by the 
operator, of low address storage and current 
PSW, and the list shown on the opposite 
page. Also, refer to section 2-E-3. 
Analyze the message in bytes 0—3 to 
isolate a possible cause of the error. 



If GR 11 contains a hard wait code (see table 
opposite) or a hard wait code exists in bytes 2 
gnd 3 of low address storage, proceed to check 4 
If there is no recognizable message turn to 
chart 04. 



- Check 4 - 

Locate old PSW 



- Check 5 — 

Locate failing 
instruction address 



Use the stand-alone output to locate: 

• the old PSW applicable to the message. 

• the instruction length code (Refer to 
section 2-E-2.) 

• the interrupt code. 

The reason for the error may be that a 
transient used by the program is not 
cataloged in the system core image library. 
Execute DSERV. (Refer to section 2-C-2.) 



Use the stand-alone dump output and 
supervisor listing to locate where in the 
supervisor the program check occurred (which 
routine). Analyze the failing instruction 
and compare the code of the instruction 
in the dump with the instruction in the 
listing. 



Calculate the failing instruction address by 
subtracting the length code from the instruc- 
tion address part of the PSW. Analyze the 
cause of the program check using the 
interrupt code. If you cannot isolate the 
error with this information proceed to 
check 5. 



Make certain that user routines have not 
altered the supervisor, and that the super- 
visor assembly is free of errors. Before 
calling for IBM programming support, 
execute the program with PDA ID F/L trace 
on all partitions to trace phases used. (Refer 
to section 2-B-2.) 

Also, use the SDAID stop on event program 
check and obtain a non-destroying dump 
when the stop occurs. (Refer to section 
2-B-10.) 

If the error cannot be isolated after re- 
analysis of the problem using the output 
obtained from the re-run, inform IBM. 
Have the following information available: 

• SYSLOG output 

• Supervisor listing 

• Program listing 

• Linkage Editor maps 

• Stand-alone dump 

• Dump or copy of SYSVIS 

• PDAI D and SDAI D output 

• Job stream 

• DSERV output if one was obtained. 
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Check Method of Analysis 

Check 1 



Scan the stand-alone 
dump output 



A. Look for unexpected or unreasonable 
values in the following areas in the dump 
output: 

• PSWs in low address area (machine check 
old, program old, input/output old, SVC 
old, external old), and note interruption 
codes for the associated PSWs. 

• General purpose registers. 

• Control registers (see appendix C). 

• CSWand CAW (refer to section 2-E-2). 

B. If the dump produces a formatted output, 
scan the LUB, PUB, CHANQ, PIB, and 
ERROR O. (Refer to chapter 3 in this 
section for a description of these supervisor 
tables.) 

C. Locate SYSCOM (address of SYSCOM is 
found at location X'80-83' of low address 
storage). 

D. Locate the logical transient area. The 
address of the LTA is found at Xl C of 
SYSCOM. 

Convert the first eight bytes of the LTA to 
characters. This is the name of the transient 
in the LTA at the time the dump was taken. 
If it is a user-written transient, obtain a 
listing of the transient and check for the 
use of SVC 22 (Seize System). When the 
system is seized, no interrupts can occur 
until a second SVC 22 is issued to release 
the system. If the transient is supplied by 
IBM, inform IBM and have the following 
available: 

Supervisor Listing, Stand-alone dump, 
Jobstream, Program Listing, Linkage Editor 
maps, and SYSLOG output. 



Recommendations to Aid 
Further Problem Analysis 



• If the error cannot be isolated, re-run the 
program with SDAID IF trace function. Use 
FASTREC output class and specify as large 
an area as possible for SDAID (refer 
to section 2-B-10). 

Proceed to check 2. 



— Check 2 — 

Analyze the 
SDAID output 



Use the SDAID IF trace output to determine 
where the LPSW (load program status word) 
was given. The HARD WAIT is caused by a 
LPSW instruction that can be issued only 
when the system is in the supervisor state. 
For example, LPSW can be issued by the 
DOS/VS supervisor or any IBM routines that 
run in supervisor state. 



Compare the last few instruction addresses in 
the IF trace output with, for example, the 
supervisor listing, or if the instruction 
addresses are nbt in the supervisor area, the 
listing of the IBM routine which was running 
in supervisor state. Determine the routine in 
which the LPSW is issued. 

Inform IBM and have the following informa- 
tion available: 

• SYSLOG output 

• List of the IBM routine in which the LPSW 
instruction is issued, for example, the 
supervisor listing 

• Stand-alone dump output \ 

• SYSVIS dump or a copy of the PDS on 
tape or disk 

• SDAID IF trace output. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 1 - 

Establish task(s) 
waiting for input/ 
output interrupts 



Use the stand-alone dump output to locate 
the PIB. Make a note of the flag byte and 
address of the partition save area for each 
entry in the PIB. (How to locate the PIB and 
analyze information contained in an entry is 
described in Chapter 7 in this Section.) 



Proceed to check 2. 



Check 2 



Determine status of 
the partitions 



Determine the status of each partition by 
analyzing the flag byte. For example, a 
flag byte containing X'82' indicates that 
the task is waiting for an input/output 
interrupt. 

Locate the partition save area of each 
partition and make a note of the return 
PSW in each of the save areas. (Refer to 
chapter 1 1 in this Section.) 



Use the instruction address part of each 
return PSW to locate the instruction (in the 
dump) which will be executed when the 
partition regains control. If the sequence of 
instructions in the dump starting at this 
instruction is TM, BO, SVC 7, proceed to 
check 3. Otherwise go to check 4. 



Check 3 



Analyze the contents 
of general purpose 
register 1 






Determine if the contents of general purpose 
register 1 in the partition save area is pointing 
to a CCB. An example of a valid CCB is shown 
in Chapter 5 in this Section. 



If GR 1 is not pointing to a valid CCB proceed 
to check 4. 

If the contents of GR1 is pointing to a valid 
CCB, analyze the contents of bytes 2, 3, and 
1 2 of the CCB. (Refer to Chapter 5 in this 
Section for a description of the format and 
contents of the CCB). 

If the CCB is posted, check the seek address 
and unit check bits in the CCB. If you are 
using user-written unit check procedures, 
check that the sense data is properly tested. 

If the CCB is not posted, the device using this 
CCB is waiting for an input/output interrupt. 
Go to check 5. 



Check 4- 



Analyze the program 
or programs running 
when the wait state 
occurred. 



Use the program listing and linkage editor 
map* for each of the programs that were 
running, and, in conjunction with the instruc- 
tion address part of the return PSWs in the 
associated save areas, locate the instruction in 
each of the programs. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Determine the routine that was being executed 
in each of the programs running when the wait 
state occurred. Check the instruction coding in 
each routine for the correct use of macros, for 
example, the use of ENQ, DEQ, and WAITM 
macros. (A task may be waiting for a particular 
resource, or there may be aqDrogrammed WAIT 
for a timer control block.) 

If the track hold facility is supported, check 
that the maximum number of tracks specified 
in the TRKHLD parameter is not exceeded. 
Also ensure that one task is not waiting for 
tracks held by another task. 

For details about these macros and their for fr^a 
mat refer to the IBM publication DOS/VS 
Supervisor and I/O Macros, and for examples 
of the use of these macros and multitasking, 
refer to the DOS/VS System Management 
Guide. 

If the error can not be isolated, proceed to 
Check 5. 
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Soft Wait 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 5- 

Analyze the last 
START I/O 



Inspect the channel bucket and analyze the 

contents to obtain information about the last 

input/output operation started on each 

channel. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 6. 



Check 6 

Determine the I/O 
device involved 




A. Locate the associated PUB entry to 
determine the device address. (Refer to 
Chapter 3 in this Section.) 

B. Lo cate the associated LUB entry, (via the 
JIB if necessary), to determine the logical 
unit involved. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 7. 



Check 7- 



Establish if there are 
other requests for the 
same device or if the 
CHANQisfull 



• Locate the channel queue, and check if any 
other input/output requests are queued for 
the same device. 

• Check the contents of FLPTR, if it is 
X'FF' the CHANG is full. This may be an 
indication that the CHANQ is too small for 
the type of programs in use. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 8. 



\. 






-Check 8 



Inspect the ERROR 
QUEUE 



Locate the error recovery block and check if 
there are any entries in the error queue for 
the device. 

From the error queue entry you can obtain 
the SSW, CCB address, and Message Code. 
Use the message code to locate the meaning 
and possible cause of the message by referring 
to the DOS/VS Messages manual. 
(Refer to Chapter 3 in this Section.) 



If the error can not be isolated, inform IBM 
of the problem, and have the following 
information available: 

• SYS LOG output 

• Stand-alone dump 

• SYSVISdumpor copy of the PDSon tape 
or disk 

• Job stream 

• Description of system environment and 
conditions under which the program is 
executed. 

Otherwise make corrections to ypur program 
as necessary. (This may require a new 
assembly of the supervisor, or re-running 
the program using a supervisor that can 
accommodate the required input/output 
operations.) 



c 
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Check 
Check 1 



Approximate location 
of the loop 



Check 2 



Eliminate 
components 






Check 3 

Preparation for 
problem analysis 
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Method of Analysis 




Use the trace of the loop (SDAID BR trace 
output or manual trace) and any notes made 
by the operator to inspect the path made by 
the loop. Also, use the linkage editor map and 
stand-alone dump to check if the loop 
addresses are within the DOS/VS supervisor 
or in the POWER/VS partition (if POWER/VS 
was initiated when the malfunction 
occurred) or in a module used by the 
program. 



• Is the loop in a user written module? 



Yes 



'Are any other programs using the same 
module? I 



Yes 



• Did these programs that use this common 
module generate unintended loops? 



A. If the loop is in the program, use the pro- 
gram listing, the trace of the loop, stand- 
alone dump, and program logic charts for 
analysis. 

B. if the module is suspected of causing the 
loop, use the listing and logic charts of the 
rrxjdule for analysis. 



Also, check if any changes have been applied 
to the module since the last time the prograrn 
ran successfully. 



No 



No 



No 



Yes 



Unintended Loop 
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Recommendations to Aid 
Further Problem Analysis 



If the loop is entirely within the DOS/VS 
supervisor or the POWER/VS partition or 
in an IBM module used by the program or 
in an IBM written program, inform IBM 
and have the following system information 
available: 

• SYSLOG log sheet 

• Any output from the program 

• Job stream 

• Trace of the loop (SDAID output 
if possible) 

• Stand alone dump 

• SYSVIS dump, or copy of the PDS 

• DOS/VS supervisor listing and the 
POWER/VS listing (if applicable) 

If the loop is not in the suppervisor or the 
POWER/VS partition, or only part of it 
is, proceed to check 2. 



Loop is caused by the program. Proceed to 
check 3. 



Suspect the module of causing the loop. 
Proceed to check 3. 



Loop is very likely generated by the module. 
Proceed to check 3. 



Proceed to check 4. 



Remove the changes and re-run the program. 
Otherwise, proceed to check 4. 



Check 4 



Program and problem 
analysis 



A. Check program listing and logic flow for: 

• Count locations that can never reach 
their limits. 

• Counters that are not updated. 

• Counters that are never initiated. 

• Count locations, the contents of which 
are not periodically or properly tested. 

• Check that I/O operations are able to 
reach their completion, and are not 
prevented from doing so by program 
logic. 

B. Check the counter locations in the stand- 
alone dump. They may have been over- 
written, in which case use the program 
listing to isolate the point in the program 
where the locations are prepared. 

Note: Examine the channel programs if I/O 
operations are directly responsible for 
preparing count lacations. 



-If error cannot be isolated, re-run the program 
using SDAID BR and/or IF trace functions to 
obtain a complete trace of program and 
module logic flow during program execution. 
(Refer to Section 2-B-10.) 

Also, use PDAUD F/L trace to check phases 

used by the program. (Refer to Section 2-8-4.) 

Re-analyze the problem. 

If the error can not be isolated, inform IBM. 

Have the following system information 

available: 

• SDAID output 

• SYSLOG output 

• Job stream 

• Program listing 

• Listing of module used (if module suspected) 

• Trace of loop 

• Stand-alone dump 

• SYSVIS dump or copy of PDS on tape or 
disk 

•fniDAID output. 
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Check Method of Analysis 

Check 1 



Gather any information 
pertaining to program 



Recommendations to Aid 
Further Problem Analysis 



"~\ 



A. Ascertain System Environment (Super- 
visor, DOS/VS release number, I/O 
devices used, modules used, etc.) 

B. Obtain SYSLOG output from the job, and 
if possible the input job stream and input 
files. (This depends on many circum- 
stances, such as time involved, storage of 
output from previous runs, original input 
files already overwritten for other jobs 
etc.) 

C. Program listing and linkage editor map. 



D, Ascertain the status of the machine at the 
time the job ran. For example, find out if 
an I/O unit in use for the program 
developed an error and analyze its effects 
on the program. 



Turn to check 1 of chart 06 and analyze the 
problem using all available information. 
Try to simulate the same conditions for a 
re-run of the program. 
Use chart 06 for error isolation. 



Re-run program; execute a system dump 
or stand-alone dump when incorrect output 
is detected. 
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Check 1 



Environment 



Was the program operating under POWER/VS 



Yes 



No 



-Check 2 



Type of program 
producing the 
incorrect output 



-c 



Userwritten? 



Check 3- 

Type of incorrect 
output 



IBM-supplied program? 
Assembly language compiler 

High level language compiler (RPG II, 
FORTRAN, etc.) 

IBM library program (DSERV, SORT/ 
MERGE) etc. 



Use any output from the program and 
messages printed during program execution 
to determine the type of/incorrect output 
according to the following categories: 



• Duplicate (identical lines printed) 



Lack of (missing data printed). 



• Too much or unexpected (more data printed 
than expected). 



Turn to chart 13. 



Proceed to check 2. 



Proceed to check 3. 



Inform IBM and have the following informa- 
tion available: 

• All output from the program 

• SYSLOG output 

• Job stream 

• Input files 

• Supervisor generation notes and level of 
release 

• Listing of the support for the failing 
program 

• Notes about system type and model, and 
any notes about system status and input/ 
output units used for the program. 



Use the program listing and analyze the 
coding, checking for: 

• Unnecessary program loops in input/ 
output routines 

• Routines not being entered or completed 

• Overlaid input/output areas. 

If necessary, re-run the program using 
SDAID IF, SA, and GA trace functions. 
Specify event limits that will adequately 
cover routines that prepare output areas. 
(Refer to section 2-B-10.) 
Re-analyze the output from the re-run. 
If the error can not be isolated proceed to 
check 4. 



o 
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Check Method of Analysis 



Check 4 - 

System condition 
during program 
execution 



Check 5 



Job stream 



Were there any abnormal interruptions in 
computer operations during execution of the 
program? 



Yes 



No 



Were any abnormalities observed in system 
actions or response to messages by the 
operator during program execution? 



Yes 



No 



Check that the correct job stream was used for 
the program. This applies also to job streams 
cataloged on the procedure library. 
(Use PSERV to display the procedure 
library; refer to section 2-C-3.) 



Recommendations to Aid 
Further Problem Analysis 



Analyze the possible effects of any interrup- 
tion, and re-run the program ensuring no 
interruptions. 



Re-run the program and note any unex- 
pected system actions. Ensure the correct 
response is given to messages issued. (Refer to 
the DOS/VS Messages manual). 
Use any notes made to analyze program logic. 
If necessary, re-run the program using with 
the SDAID IF trace to aid analysis of pro- 
gram logic. 
Check the input used for the program. 

Proceed to check 5. 



If error isolated, make corrections as 
necessary and re-run the program. 

If error can not be isolated, proceed to 
check 6. 






Check 6 



Input used 



Isolate suspected areas on the input files 
by examining the output from the program. 
For example, a missing record in the 
output indicates the approximate area on 
the input file that may be in error. 



B. Check the labels and volume ID and extent 
information. Use LSERV and LVTOC, or 
for VSAM files use LISTCAT Access 
Method Services utility commands. 



A. Obtain a dump of suspected areas on the 
input files used. For VSAM files use the 
Access Method Services utility program 
PRINT command. (Refer to section 2-C). 

B. Check input/output file macro 
definitions in the program listing against 
characteristics of data on the input files. 
DTF (LIOCS), CCB (PIOCS) 

ACB, RPL, and GENCB (VSAM). 

Compare the output of the LSERV, LVTOC, 
and LISTCAT programs with DLBL/EXTENT, 
VOL ID, data in the job stream. 
If no errors can be found, proceed to check 7. 
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Check 



Check 7 



Dump of partition 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Yes 



Did the operator obtain a dump of the 
partition containing the failing program? 
For example, a stand-alone dump, a system 
dump, or a dump obtained by using the 
DUMP command. 



Inspect input/output areas in the dump, also 
inspect CCBs and channel programs. (Refer to 
chapter 5 in this section.) 
If no errors are found proceed to check 8, or 
if satisfied with the information that can be 
obtained from the dump go to check 10. 



No 



Proceed to check 8. 



Check 8 

Obtain a non- 
destroying dump 






Use the program listing and the information 
already obtained from the previous analysis 
of the problem to isolate the approximate 
area of the failure. 

For example, a specific input/output area, 
or a specific work area. 



Re-run the program with SDAID IF and/or 
SA trace function. Specify a stop on event 
and obtain non-destroying dumps at specific 
instructions, or specific storage alterations. 
(Refer to section 2-B-10.) 

Also, as a further aid for problem analysis, 
use the PDAID F/L trace to trace phases 
used by the program. 

Proceed to check 9. 



Check 9 



Analyze the SDAID 
dump output 



A. Inspect input/output areas, CCBs, and 
channel programs in the non-destroying 
dump output. 

B. Compare input/output areas as defined 
in the DTFs, CCB and CCW macros, and 
ACB, RPL and GENCB macros in the 
program listing, with the areas as printed 
in the dump. 

C. Check the sequence, names, and load/ 
entry addresses of the phases used by the 
program, and compare them with the 
linkage editor map addresses. 

D. Use the program listing and dump output 
to inspect values in registers and storage 
locations used for intermediate results. 



If no errors can be found and the cause of the 
error can not be isolated, proceed to check 10. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 10 



Unusual conditions 
generated by the 
program and its input 



Cfiecl< that the program logic and counters can 
accommodate unusual conditions and circum- 
stances of input. For example, data changes 
(year), or extraordinary changes in amounts 
and quantities. 



If the error can not be isolated, proceed to 
eheck 1 1 . 



Check 11- 

Preparation of the 
input files 



Check the input used for this program. If 
necessary, analyze the program that prepared 
the input files, starting at check 1 of this 
chart. 



If the input is correct, and the prograrn that 
generated the input is not at fault, proceed 
to check 12. 



Check 12- 



Gather more system 
information 



Re-run the program, using, if possible, newly 
prepared input data that is known to be correct 
Try to simulate or run under identical condi- 
tions to those in which the failure occurred. 



A. Re-run the program with the PDAID F/L 
trace, to trace phases used by the program. 
(Refer to Section 2-8-4.) 

B. If you have not carried out the recommen- 
dations listed in checks 8 and 9 of this 
chart, initiate the SDAID IF, and/or SA 
trace functions. Use specific addresses for 
the event limits that are related to the 
problem, based on your previous analysis. 
(Refer to Section 2-B-10.) 

C. Before re-running the program, re-assemble 
it using the PDUMP macro to dump all 
input/output areas before and after every 
input/output operation. 

(Refer to Section 2-A-5.) 

If the program is using VSAM files, re- 
assemble the program and insert the 
TESTCB or SHOWCB macros, before 
and after each OPEN, GET and PUT. (Refer 
to Chapter 4 in this Section.) 

If, after re-analysis of the problem using the 
output from the re-run, the error can not be 
isolated, inform IBM and have the following 
information available: 

• All program output, whatever it is 

• All dump output 

• SDAID/PDAID output 

• SYSLOG output 

• Job stream 

• Any notes pertaining to the problem 

• Notes about system environment and 
condition. 



'4.,.y 
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Check 

Check 13 

Eliminate 

components 

used. 



Method of Analysis 



• Without initiating a POWER partition or 
running under POWER RJE re-run the 
program producing the incorrect output. 



Are other programs generating incorrect 
output when running under POWER or 
POWER RJE 



Recommendations to Aid 
Further Problem Analysis 



3 



If program still generates incorrect output, 
analyze the problem starting at check 1 of chart 
06, part 1 . Otherwise suspect the POWER or 
POWER RJE partition and proceed to check 14 



Yes 



Proceed to check 14 



- Check 14 - 

Programs falling 
which run under 
control of POWER 
or POWER RJE 



Inspect the contents of general purpose register 
7 printed at the beginning of a system dump or 
stand-alone dump executed just before the 
malfunction occurred. This register should 
contain the address of the TIB of the active 
POWER or POWER RJE routine just before the 
dump was executed. 






If the program is run under POWER consult 
Appendix K, or if run under POWER RJE 
Appendix L. 

By using the system information and Appendix 
K or L (as applicable), you may be able to 
isolate the cause of the error. In any case it is 
recommended that you inform IBM of the 
problem and have the following information 
available: 

• SYSLOG output 

• Stand-alone dump 

• A dump, or copy of SYSVIS 

• Dumpof the QFILE 

• Supervisor assembly listing 

• POWER SCP assembly listing 

• Job stream 

• Any notes made during system operation 
when the malfunction occurred. 

You may re-run the program under POWER or 
POWER RJE with the following aids. 

A. Use PDAID I/O or QTAM trace functions to 
trace I/O operations on all units used by the 
program producing incorrect output, and by the 
partition owning POWER/POWER RJE. (Refer 
to section 2-B-4). 

B. Use SDAID BR function on the partition 
owning POWER to trace the logic flow during 
program execution (Refer to section 2-B-10). 

C. As an option, re-run the program using 
PDAID F/L trace on the partition owning 
POWER to trace phases used. (Refer to section 
2-B-4). 



o 
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Check 



Check 

Type of 
cancellation 



Method of Analysis 



N 



Program Check. 



Illegal SVC. 



Program canceled by Program Check 

CHART 09, PART 1 OF 4 

Recommendations to Aid 
Further Problem Analysis 

Proceed to check 2. | 

Turn to chart 10, i 



Other (for exannple, operator cancellation). [""^^H Turn to chart JT 



Check 2 



Area of failing 
instruction 
(Level 1) 



Is message 1Q30D ABNORMAL 

POWER/VS TERMINATION. 

PRINTER^ 

issued on SYSLOG just after 

the program check message? 



No 



Is the program check in the SVA? 
There are two methods to establish this: 

1 . From the MAP command output check if 
the instruction address shown in the Program 
Check message is within the SVA. 
(The MAP command should have been issued 
by the operator immediately after the Program 
Check occurred) 

2. If a System Dump was executed when the 
Program Check occurred and the Program 
Check was in the SVA, a dump of the SVA (or 
part of it) will be preceded by the following 
message printed in the dump output: 

PART OF SVA WHICH CAUSES ERROR 






X 



Checks 



No 



Area of failing 
instruction (Level 2) 



Use the load and entry addresses of phases and 
modules used by the program as indicated on 
the linkage editor map,* and the error message 
to locate in which area the program check 
occurred: 



I •Program check in user program area 



►Program check within the supervisor area 
(The address of the end of the supervisor is 
contained in bytes X'20'-X'23' of SYSCOM 
and the address of SYSCOM is contained in 
bytes X'80'-X'83' of the low address storage.) 



•Program check within the partition 
containing the POWER/VS SCP or 
POWER RJE system control programs 



Check 4 



Location of failing 
instruction 






Use the linkage editor map as in check 2 above, 
to determine whether: 

• the program check is within the user-written 
program, 

• or in a user-written module used by the 
program. 

Note: 

If the program check is within an IBM-supplied 

module used by the program, and no system 

dump was executed when the program check 

occurred, re-run the program with the 

// OPTION DUMP statement in the job stream. 

(Refer to Section 2-A-2) Otherwise inform IBM 

and have the following information available; 

• SYSLOG output 

• Job stream 

• System dump output 

• Program listing and linkage editor map. 



This indicates the program check occurred 
within the POWER/VS partition. 

Turn to chart 13, check 5. 



Yes 



If a System Dump was executed, you may be 
able to isolate the error by using the information 
already available to you. If this is the case, go to 
check 1 3 on part 4 of this chart. 

If a System Dump was not executed, it will be 
necessary to re-run the job and include the 
,/ OPTION DUMP statement in the job stream 
before going to check 13 on part 4 of this chart. 
Also initiate the SDAID dump on event Program 
Check (refer to Section 2-B-10) and if your 
system suports PDA ID, initiate a FETCH/LOAD 
trace to trace the phase being loaded in the 
SVA. (Refer to Section 2-B-4). 



Proceed to check 3 




Proceed to check 4. 



Turn to chart 1 2. 



Turn to chart 1 3. 



Proceed to check 5. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 
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Check 



Method of Analysis 



Check 5 

Analyze failing 
instruction and 
type of program 
check 



Can the cause of the failure be isolated using 
the program listing, error messages, and job 
stream? 



Yes 



No 



Recommendations to Aid 
Further Problem Analysis 



Make correction as necessary and re-run the 
program. 



■^^►j Proceed to check 5. 



Check 6 



Dump of 
partition available? 



Was a system dump executed when the 
program check occurred? (System dump is 
described in Section 2-A-2). 



Yes 



No 



Proceed to check 7. 



Re-run the program with // OPTION DUMP 

statement in the job stream. 

Also, use the SDAID stop-on-event program 

check and obtain a non-destroying dump. 

(Refer to Section 2-B-10.) 

When you have obtained the dumps 

continue problem analysis from check 7 of 

this chart. 



Check 7- 

Analyze dump of 
partition (Level 1 ) 



Use error messages, linkage editor map*, and 
program listing to locate failing instruction in 
the Dump. 
(An example is shown in Section 2-E-3.) 



If the instruction and code appears correct 
and has a valid operation code and data 
field, proceed to check 8. 
If the program check message indicates an 
error in input/output operation in your 
program, go to check 10; otherwise proceed 
to check 8. 



'\^ 



Check 8 — 

Analyze dump of 
partition (Level 2) 



Locate the partition save area and inspect 
the contents of general purpose registers. 
(The location and format of partition save 
areas are described in Chapter 1 1 of this 
Section.) 



B. Use program listing, and linkage editor 
map* to locate data areas in the dump used 
by the failing instruction. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Look for unreasonable or totally unexpected 
values in the general purpose registers. If you 
find any that are connected to the failing 
instruction, locate the code in the program 
listing responsible for preparing the register(s). 
(General register usage is described in 
Chapter 9 of this Section.) 
If the cause of the error can not be isolated, 
proceed to check 9. 



Depending on the type of program check 
indicated by the error message, inspect data for 
validity, duplication, missing information, and 
sequence errors. 

If the cause of the error cannot be isolated, 
proceed to check 9. 



O 
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Check 



Method of A na lysis 



Check 9- 



Analyze the general 
register and data 
preparation 
instructions 



Inspect the program logic and instructions 
responsible for preparing the general 
registers and data areas used by the failing 
instruction. 



Recommendations to Aid 
Further Problem Analysis 



if an input/output operation is involved, 
proceed to check 10; otherwise, go to check 1 1 



Check 10- 

Analyze the input/ 
output operation 



Locate and inspect command control blocks 
(CCBs) and channel programs in the system 
dump as described in Chapter 5 in this Section. 
Note: to locate and analyze CCBs and channel 
programs for programs using VSAM 
files, consult the description given in 
Chapter 4 in this Section. 



If it is an input operation, and this input is used 
to prepare the general registers or data fields 
used by the failing instruction, you may suspect 
the program that produced the input. 
Proceed to check 1 1 , or first analyze the 
program that provided the input to this program 
by following the recommendations given in 
charfOS (incorrect output). 



Check 1 1 — 

Prepare a program 
re-run to gather more 
detailed system 
information 






Use SDAID SA and/or GA trace functions if 
you suspect that data of general register 
alteration is the cause of the error. Specify 
address limits on the suspected areas 
calculated from the start of the partition in 
which the program is re-run. Refer to Section 
2-B-10.) 
Note: the SA trace can not be used to trace 

areas altered directly by input/ 

output operation. 
If the logic flow of the program during 
execution is in doubt, use the SDAID BR 
trace function on the partition in which the 
program is re-run. 



B. If the program is running in virtual nrode or 
using user written channel program 
translation routines, use SDAID stop-on- 
event program check and obtain a non- 
destroying dump. (See note) 

(Refer to Section 2-B-10.) 

C. If the program is running in virtual mode 
and using the IBM-supplied channel pro- 
gram translation routine, check that your 
program is not violating the rules for 
channel program translation support. 



Proceed to check 12. 



Check the general rules applicable to channel 
program translation routines. (Refer to 
Chapter 13 in this Section.) 



Note: The SDAID non-destroying dump 

enables you to analyze the CCB/CCW 
copy blocks and the CCW/TCB in 
the supervisor area. Note that these 
blocks may be overwritten by the 
system dump when analyzing the 
output from a system dump. 
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Check 12 

Re-analyze the 
output from the 
program re-run 



Use all the information obtained from the re-run 
and re-analyze the problem. If the error cannot 
be isolated, you may either inform I BM or re- 
assemble the program, inserting one or more of 
the following assembly macros in your 
program. Then re-run the program. 



• PR INT GEN (to obtain an expansion of all 
macros in used by the program). 

• PDUMP (to obtain the dumps of selected 
areas of storage, such as input/output areas, 
during program execution. Refer to Section 
2-A-5) 

• DUMP or JDUMP (to obtain a dump of 
partition and supervisor at a point in the 
program before the program check occurs. 
Refer to Section 2-A-5.) 



If you choose to inform IBM, have the 
following information available: 

• SYSLOG output 

• Job stream 

• SDALD output 

• Program listing and linkage editor map. 



Re-analyze the problem using output obtained 
from the re-run. Examine the expansions of 
macros used by the program and check the 
DTF macros used for file definition with the 
program listing. 

if the error can not be isolated, inform IBM 
and have all information obtained from program 
re-runs, plus any notes made of your previous 
analysis. 



Check 13 

Analyze dump 
of the SVA 



If it is known which program or phase 
in the SVA caused the program check, 
use error messages and program listing 
to locate the failing instruction in the 
dump. (An example is shown in Section 
2-A-2of this manual). 

If the name of the phase in the SVA 
that caused the program check is not 
known, use the PDAID FETCH/LOAD 
trace output to locate the last phase 
used by the program. 
The load address of the phase should be 
the start address of the SVA printed in 
the dump. 



Compare the hex code of the failing 
instruction given in the assembly listing 
with the hex code in the dump output. 
If the instruction and code appears to be 
correct and has valid operation code and 
data fields specified, continue problem 
analysis from check 8 on part 2 of this 
chart. 

If the program check message indicates an 
error in I/O operations, continue problem 
analysis from check 10 on part 3 of this 
chart. 
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Program canceled by Illegal SVC 

SUPPORT FOR CHART 10 



The complete text for message OS04I is: 

ILLEGAL SVC- HEX LOCATION nnnnnn - SVC 
CODE nn 

where nn is in hexadecimal notation. 

This message results from the following causes; 

1. When nn is 02: The phase name given does not start with 
^$B,or 

For LIOCS, macros called in invalid sequence. As a result, 
on SVC 8 is issued after an SVC 2 before an SVC 9 has 
been issued to free the transient area, or 

For other conditions, the user specified a temporary exit 
(SVC 8) for a logical transient. In the temporary exit 
routine, another routine is called (by an SVC 2) before 
an SVC 9 is issued to free the transient area. 

2. When nn is 05: The 'to' range specified in the MVCOM 
macro is invalid. 

3. When nn is OA, 1 2, 1 3, or 1 8: The supervisor was 
generated without the timer option. 

4. When nn is OB: The call was not given by a logical 
transient routine. 

5. When nn is 1 6, 1 7, or 1 A: The caller did not have a PSW 
key of zero. This is applicable only in a multiprogramming 
system. 

6. When nn is 23: More than 16 holds have been issued for 
the same track. 

7. When nn is 24: Free a non-DASD or a track that is not 
held. 

8. When nn is 26: A subtask issued attach, or the save area 
is not on a doublewttrd boundary. 

9. When nn is 27: A main task issued detach without 
SAVE = parameter, or 

A main task issued detach, but the ID of the subtask in 
the save area passed is not valid, or 

A main task attempts to detach on already terminating 
subtask. 

10. When nn is 29: A DEQ is issued by a task that did not 
END the resource. (This is valid in an AB routine.) 



1 1 . When nn is 2A: A subtask (without an ECB = parameter) 
has issued an ENQ nnacro, or 

A subtask has issued an ENQ macro to a resource that 
has not been dequeued by another task that has been 
terminated, or 

A task has issued two ENQ macros to the same resource 
without an intervening DEQ. 

12. When nn is 2D: Emulator execution was attempted, but 
the EU parameter of the SUPVR macro was omitted or 
incorrectly specified during system generation. 

13. When nn is 32: For LIOCS: 

a. An imperative macro (such as WRITE or PUT) was 
issued to a module that does not contain the 
requested function, or 

b. A PUT was issued for an ISAM retrieve module 
without a preceding GET, or 

c. An invalid ASA first character for the printer 
was used, or 

d. A wrong length record indication occurred while 
processing 1287 documents when 
RECFORM=UNDEF,or 

e. The 1287 program erroneously contained a CCW(s) 
with the SLI flag bit 'OFF', or 

14. When nn is any other value: The supervisor function 
requested by the operand of the SVC is not defined 
for the supervisor being used. 



-^¥v 






Causes for Message 0S04I (Cancel Code X'21') 
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Check 



Method of Analysis 






Recommendations to Aid 
Further Problem Analysis 



Check 1 

Supervisor support for 
the SVC code printed 
in the error message 



Use the supervisor listing to checl< if the option 
used by the SVC is supported. For example, 
SVC X'43' must be supported by a supervisor 
generated with PFIX = YES. 



Compare the SVC code printed with the list of 
SVCs given in Chapter 6 of this Section. 



If the option is not supported, avoid the use 
of the SVC by the program, or re-assemble 
the supervisor, or re-run the program using 
a supervisor that supports the option. 



If the SVC code printed in the error message is 
not listed, go to check 3. 
Use the figure opposite to isolate possible 
causes of error if the error message is 0S04I. 
If the option is supported and no reason can be 
established for the error, proceed to check 2. 



Check 2 



Location of SVCs 
issued by the program 



Use the program listing and linkage editor map" 
to locate where the SVC is issued. 
Note: To ensure that all SVCs issued by the 
program are checked, use a program listing 
that shows the expansions of the macros used. 
(If such a listing is not available, you will have 
to re-assemble the program with the 
PRINT GEN assembly control statement.) 



Check the sequence of SVCs issued and macros 
used to ensure that the program is written to 
enable correct use and sequence of SVCs. 
If there is any doubt about the sequence of 
SVCs issued by the program, re-run the 
program with the PDAID GSVC trace. (Refer 
to Section 2-B-4.) If the error can not be 
isolated, proceed to check 3. 






Check 3 — 

Dump of partition 



Was a System dump taken when the program 

check occurred? 

(System dump is described in Section 2-A-2.) 



No 



Re-run the program with the // OPTION DUMP 
statement in the job stream, or initiate the 
SDAIDdumpon event program check (refer 
to Section 2, B-10-F). 



Yes 



Proceed to check 4. 



Check 4 



Analyze the dump 



Use the program listing, error message, linkage 
editor map*, and system dump to locate the 
SVC instruction in the dump. 



If the program has been link edited using 
the DOS/VS relocating loader option, the 
relocation factor must be calculated based on 
the start address of the partition used for 
the program when it failed. 



o 



Compare the hexadecimal code for the SVC in 

the dump with the SVC instruction in the 

program listing. 

If there are differences, analyze the program 

to isolate the point where the correct SVC 

instruction is overwritten. 

As a further aid in this analysis, you may need 

to re-run the program with the SDAID SA 

trace. Use the STOP ON EVENT option and 

obtain a non-destroying dump at the point 

suspected of causing the overwriting. 

If there are no differences and the error can not 

be isolated, inform IBM and have the following 

ingormation available: 

• Supervisor listing 

• Program listing, including the macro 
expansions 

• Linkage editor map 

• System dump 

• SYSLOG output 

• Job stream. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 1 



Reason for program 
cancelation 



Did the operator cancel the program? 



Yes 



Inspect messages printed on SYS LOG and 
SYSLST prior to the cancelation. If necessary, 
interview the operator to establish system 
activity during program execution. (It is possible 
that incorrect response to messages issued during 
program execution caused an unusual condition 
to occur.) 
Proceed to check 2. 



No 



Examine the program listing and check for 

the use of DUMP or CANCEL macros left in 

the program from testing phases (program 

testing). 

Remove these macros and proceed to check 2. 



Check 2 



Re-run the program 



Re-run the program. If possible, be present 
during the re-run to observe system activity. 
Follow the recommendations given in DOS/VS 
Messages manual, and ensure the correct 
response is given to messages issued during 
program execution. 

Ensure the use of the //OPTION DUMP state- 
ment in the job stream, to obtain a system dump 
when the program is canceled. (Refer to 
Section 2-A-2.) 



If the identical error recurs, it may be due to 
the incorrect use by the program of an IBM- 
supplied routine. 

Inform IBM and have the following information 
available: 

• SYS LOG output 

• SYSLST output 

• System dump output 

• Job stream 

• Program listing and linkage editor map. 
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Program canceled by Program Check in Supervisor 

CHART 12, PART 1 OF 3 






Check 



Check 1 



Approximate the area 
where the program 
check occurred 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Is the program check within the logical 
transient area? (iVlessage 0S08I followed by 
message 0S1 1 1 will inform you where the 
instruction address, (the program check 
occurred) is located. 



No 



Go to check 8. 



Yesr 



Proceed to check 2. 



Check 2 



Dump available? 



Was a system dump executed at the 
occurrence of the program check? 
(Refer to Section 2-A-2.) 



No 



Yes 



Re-run the program with the //OPTION DUMP 
statement in the job stream. Also, initiate the 
PDAID transient dump program, described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
After the re-run, go to check 4. 



Proceed to check 3. 



o 



Check 3 



Analyze the system 
dump to determine the 
name of the logical 
transient 



Use the system dump to locate the partition 
save area. (Refer to Chapter 12 in this Section.) 
Locate the return PSW in the save area and 
determine the failing instruction address. 
Locate this address in the dump and go two 
bytes to the left. 

Is the contents of these two bytes X'0A02' 
(SVC 2)? 



Re-run the program and initiate the PDAID 
transient dump program as described in 
§ection 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
(Also include the //OPTION DUMP statement 
in the job stream to obtain a system dump.) 
Proceed to check 4. 



Locate the general purpose register 1 in the 
save area. This consists an address. 
Locate this address in the dump and convert 
the first 8 bytes, starting from this address, to 
characters. This is normally the name of the 
logical transient fetched by the program. 
(For OPEN or CLOSE register 1 may point 
to the DFT). 

Note: The cause of the program check need not 
necessarily be in this transient, since a logical 
transient may need to fetch another transient 
to complete a service. The program check 
could therefore be caused by incorrect para- 
meters being passed to the transient. 
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Check 



Method of Analysis 



Recomrr^encfations to Aid 
Further Problem Analysis 



Check 4 



Determine the 
name of the logical 
transient fetched 



Use the PDAID transient dump output to 
determine the name by converting the first 
8 bytes of the dump to characters. (Refer to 
the example of a transient dump output given 
in Section 2-A-4.) 



Use the SDAID non-destroying dump output to 
locate Byte X'1 C of SYSCOM which contains 
the address of the logical transient area. 
(The address of SYSCOM is contained in 
bytes X'80-83' of the low address storage. 
(Refer to Section 2-E-2.) 
The first 8 bytes of the LTA, when converted 
to characters, give the name of the logical 
transient fetched. 



Proceed to check 5. 



Check 5 



No 



Type of logical 
transient program 



Is the logical transient user-written? 



Use the problem program listing and the system 
to determine the routine that was being 
executed when the program check occurred. 
Then determine which macro in the routine 
was responsible for fetching the logical 
transient. For example, the OPEN macro will 
cause the logical transient $$BOPEN to be 
fetched. 

If the error can not be isolated, inform IBM and 
have the following information available: 

• SYSLOG output 

• PDAID/SDAID output (if available) 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



/^' 



Yes 



Proceed to check 6. 



Check 6 



PDAID or SDAID out- 
put available? 



To complete problem analysis you will require 
the PDAID transient dump output, or a non- 
destroying dumpoutput from the SDAID 
program. 



If you have already re-run the program and 
obtained one or both of these dumps, proceed 
to check 7. Otherwise, re-run the program, 
following the recommendations given in check 2 
before proceeding to check 7. 



4.28 Debugging for Programmers, part 1 . 



/^., 



Check 



Check?. 



Analyze the dump of 
the logical transient 
area 



Method of Analysis 



Program canceled by Program Check in Supervisor 

CHART 12, PART 3 OF 3 

Recommendations to Aid 
Further Problem Analysis 



Use the PDA! D/SDAID output and the 
assennbly listing of the logical transient fetched 
to locate the failing instruction address in the 
logical transient area. 



A Locate the general registers at the top of 
the dump. 



J 



Locate data preparation areas that are used 
by the failing instruction in the dump. 
Check the instructions in the assembly 
listing of the Logical Transient that is 
responsible for preparing data areas for use 
by the failing instruction. 



Look for unreasonable or totally unexpected 
values in the registers. If you find any that are 
connected with the failing instructions locate 
the code in the assembly listing that is 
responsible for preparing the register(s). 
If the contents of the general registers 
appear to be correct proceed to check 8. 
(General Register usage is described in 
Chapter 9 of this Section), 



Depending on the error message, inspect data 
used by the failing instruction for validity, 
duplication, and missing information. 

If the error can not be isolated, inform IBM 
and have the following information available: 

• SYSLOG output 

• PDAID/SDAID output 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



-Checks- 



Isolate area in the 
supervisor causing the 
program check 



Use the error message and assembly listing of 
the supervisor to determine in which routine 
in the supervisor the program check occurs. 



Before informing IBM of the problem, re-run 
the program with the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump when the program check 
occurs. (Refer to Section 2-B-10.) 
Have the following information available. 

• SYSLOG output 

• Job stream 

• SDAID output 

• Supervisor listing 

« Program listing and linkage editor map. 
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Check Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



-Check 1 — 

Eliminate 
components 
(Level 1) 



Rerun the job under DOS/VS, that is do 
not run as a POWER/VS job and do not 
initiate a POWER/VS partition. Ensure 
to include the // OPTION DUMP state- 
ment in the job stream and as an option 
initiate the SDAID dump on program 
check. (For jobs entered under RJE you 
must submit the job stream and input 
data files to the central station, request 
output to be directed to a local LST 
and/or PUN.) 



If the malfunction recurs, analyze it 
using the dumps obtained as indicated 
in this section commencing at Chart 01 . 

If the malfunction does not recur 
proceed to check 2. 



Check 2 

Programs fail 
when run under 
POWER/VS only 



Has the program ever run correctly 
under POWER/VS? 



No 



Check the following. 

• Errors in JECL and device assignments. 

• Condition of spooling devices and disk 
packs. 

• The level of, and support for 
POWER/VS in the DOS/VS supervisor. 

• Storage requirements and options 
specified in your version of 
POWER/VS. 

Try to correct any obvious errors. 



Yes 



Check the following: 

• Changes in job stream JECL 

• Changes in the DOS/VS supervisor 

• Changes to data files/volumes 

o Changes to POWER/VS (regeneration 
or application of PTFs) 

• Condition of spooling devices and 
disk packs 



W^ 



Determine if other programs are 
failing when run under the same 
version of POWER/VS. If so, contact 
the programmers concerned - they 
may have isolated the reason already. 
Proceed to check 3. 



-Check 3- 



Wait state 



Was the type of malfunction 


Yes 


Proceed to check 4 and rerun the job 
as advised in that check but 
immediately the wait state occurs 
execute a standalone dump exactly 
as described in Section 2, A-3-F. 
Then go to check 5. 


a wait state? 






No 








Proceed to check 4. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Aan lysis 






Chprk n 












Eliminate 




Was the failing job entered or output via 
terminal under POWER/VS RJE ? 


Yes 


Submit job stream and data to the central 
station to be entered via local units. Request 






componfints 
(Level 2) 








output to a local LST and/or PUN. It is 
advisable for you to supervise program 
execution at the central station to note 














No 






system activity and avoid interruptions 






during job execution. Ensure the 






// OPTION DUMP statement is included 






in the job stream and request the control 






station to initiate SDAID dump on program 






check. After the input is spooled issue the 






PDISPLAY ALL command to obtain the 






status of ALL queues. Issue this command 






again just before the output (LST or PUN) 






tasks are started. 






In case of incorrect output the queue 






records and their associated data records 






belonging to a specified job name can be 






dumped. (See appendix L, POWER/VS 






File Dump Program.) 






• If the malfunction recurs, proceed 






to check 5. 






• If the malfunction does not recur 






inspect the RJE line used by the RDR 






input for the job stream or RJE pro- 






cessing within the POWE R/VS SCP. 






Go to check 6. 




^ 


If the error cannot be isolated by the pre- 




vious general checks, rerun the job under 




POWER/VS with the SDAID dump on pro- 




gram check initiated. Also ensure that the 


Phnrlr ^ 


// OPTION DUMP statement is included in 


OncCK O 




You may suspect the POWER/VS SCP 




the job stream. After the input has been 
spooled issue the PDISPLAY ALL command 


POWER/VS SCP 




of causing the error. Inform the IBM 




error 




CE/SE and have the following 
information available: 
• SYS LOG log sheet 




to obtain the status of all queues. Issue this 
command again just before the output 
(LSTor PUN) tasks are started. 








• System dump) 

• SDAIDdumpi 




In case of incorrect output the queue 






, records and their associated data records 




• Input job stream 




belonging to a specified job name can be 




• Line printer (LST) output 




dumped. (See appendix L, POWER/VS 




• Standalone dump. 




File Dump Program.) 




and note of low ^ 




• If the malfunction recurs, proceed 




address storage, f 




to check 5. 




plus PDS dump ' 




• If the malfunction does not recur, no 




• PDISPLAY command output 




further analysis as to the cause of the 




• Notes on your analysis 




original failure can be done. However, 




• POWER/VS SCP assembly listing 




inform IBM and keep a record of the 






and linkage editor map 




problem and its solution. 



-Check 6— 

RJE line or 
processing 



You may suspect the RJE line used 
for job input or the processing of 
RJE under POWER/VS. 



if applicable to the type 
of malfunction. 

contained on SYSLOG 



To verify the line, re-run the 
job using the RJE I/O trace 
(See Appendix J) 

• Inform IBM and have the following 
information available." 

• SYSLOG log sheet 

• System dump \^ 

• SDAID dump I 

• Input job stream 

• Line printer (LST) output 

• Standalone dump, 
and note of low 
address storage, 
plus PDS dump 

• PDISPLAY command output » 

• PINQUIRE I 
command output 

• RJE I/O trace output (in dump) 

• Notes on your analysis 
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The figure below illustrates the general organization of virtual storage. 

The supervisor is loaded in the real address area beginning at virtual address byte 0. 
Virtual storage can extend up to 16 million bytes. The figure also shows the general 
organization of the supervisor. Each area within the supervisor is described in more 
detail in this Section, except for the low address area and the PD area which are 
described in Section 2. 



GENERAL ORGANIZATION 
OF VIRTUAL STORAGE 



^%, 
\,^ 



1 


L 


Supervisor 




BG-R 




F4-R 


Rea 


F3-R 


Address 


F2-R 




> 


F1-R 


\ 


Main Page Pool 
(for programs 
executing in 
virtual mode) 


1 


1 


BG-V 

(Minimum always 
64K) 




F4-V 


Virtual 

Address 

Area 


F3-V 




' 


F2-V 




F1-V 


1 


Shared Virtual Area 
(not applicable to a 
single partition system) 



Partitions 

(See note) 
Background 

Foreground 4 

Foreground 3 

Foreground 2 

Foreground 1 



Low address storage 



For details, 

see Section 2-E-2. 



CPU model-dependent logout area 



Background communication region 



System communication region 



Save areas 

Option tables 

I/O tables and information blocks 



F1 Foreground communication 

F2 regions (One for each 

F3 partition specified during 

F4 system generation) 



Logical transient area (LTA) 



Physical transient area (PTA) 



PD area (optional) For details, 

see Section 2-B-3 



CCW translation routines 



Page management routines 



VSAM routines 



Machine check handler, 
Channel check handler. 



RAS transient area (RTA) 



Page management tables, 
CCW translation copy blocks 



Supervisor organization 



Note: Up to five partitions may be specified: one background and four fore- 
ground. Each partition consists of the pair "real partition - virtual 
partition ". 

The SVA and each virtual or real partition must be a multiple of2K. It may also, 
however, be 0K, except the SVA and BG virtual which must be at least 64K. 
To be active a foreground partition must have a virtual partition of at least 64K. 



Figure 4.1 The organization of Virtual Storage. ^ ... ,., 

The organization of the supervisor area is also illustrated and parts of it are described in 
this Section. 
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COMMUNICATION 
REGIONS 



Partition Communication Regions, (Comregs) 

In a multiprogramming system individual communication regions are defined for 
each partition. The communication region (comreg) belonging to the active 
partition is an area that serves as an initial pointer to other supervisor tables and 
areas. The comreg also contains pointers to user program tables and areas. The 
MVCOM and COMRG macro instructions enable access to information contained in 
these regions. Fields in the comreg are addressed relative to the first byte. The com- 
munication regions are located within the supervisor and their format is described 
in Figure 4.2 and Figure 4.3, parts 1 through 6, explain the contents of each field. 



Locating the partition communication regions 

After IPL, low address storage bytes X'14— 17' contain the address of the comreg 
used by the active partition. —————— ^.. = — — «-™.,™«-— 

Note: Tlie contents of these bytes will not be valid after executing the stand-alone 
dump program. Therefore, it is important for the operator to dump, or display 
and note, the contents of low address storage before executing the stand-alone 
dump. Locate bytes X'7C' and 'ID' in the active comreg. This is the address of 
PLB2, also referred to as the PIB (program Information Block) Extension. The first 
two bytes of an entry in the PIB2 contain the address of its associated comreg. 
(Refer to Chapter 7 in this Section for a detailed description of the PIB2.) 



Example A 



Example A below shows a dump of low address storage. Bytes X'14— 17' contain 
the address 04A0. This address has then been located in a stand-alone dump output 
as shown in example B. The address of PIB2 is indicated in this example. 
Example C shows the PIB2 from which the addresses of all the partition comregs 
are found. 






I BM....QC!OiQ!QO. ^_,^ 

• I 00000000 00000000 00000000 00000000 00000000 000(1^ 



40000000 00000000 <^ 



..4.70D.0U0.0 .00.0.40.C1C 440.C.00.0O OOOulSAA -..OOOOOOOO 00000000 470F2000 UxSoHi 



Example B 



07B7E0 E2C9C4C5 'fOEZEaOb D9C1C7C5 <»0E405C3 



000000 
000020 
000040 
000060 
000080 
OOOOAO 
OO OOCOi 

oo<5*§; 

0004C8 
0004E0 
000500 



r0900*619 
47000000 
0007B038 
440COOOO 
00000540 
OOOOOOOO 
OOOOOOOO 
F1F261F0 
00060FFF 
41044Z96 
46300000 



uuuuc 
OOOOOOOO 00020007 
OOOOOOOO 20000060 
— SAME— 

F661F7F3 70007000 
00043067 OOOOOOOO 
42974389 3F003F06 
30CC3E4C 3EBC0010 



UUUUA3I-U 

00040005 
000002CO 



OOOOOOOO 
00000010 
3F0C38F1 
OOOOOOOO 



C8CIDSC7 C5C4C3C8 C105C7C5 C4404004 ^ /— / ^ ^ / / A— A 

a /^ 000 )00O0OOOOj 4B4B4B4B 4B4B4B4B «. 4. /.../■. 

f ^"^ 000 OOOOOOOO 470F2000 0000090C 

900 01AAAB17 00080000 0000A67E C 

UUUCUOOO 0007B3AA 00080000 0000A67E 

10043010 00010000 OOOOOOOO OOOOOIEO ^ „ /- I / 

OOOOOOOO 00000100 60O0000C OOOOOOOO ( ,^^54 X 7C — " • 

OOOOOOOO OOOOOOOO 05D640D5 ClD4C540^^--{ ^ 7^ ..^...NO NAME 

OOOBFFFF FD7FCED3 1000CE50 002E40fO /U/^U*» oK p/O') .. ...l-... S.. . 

F2F0F6F7 F3F3F4F0 0000 3CD4 OflfiMOSC V^ /7«ii»"^ Y'''"<- 673340. 

00008090 00007118 00003864 C3BDjj 5A30 **"(CxS'Kt) 



Example C 



003B60 27000000 40000001 03003P 

003B80 

003BA0 

003BC0 

003BEO 

003C00 

003C20 J00400000 K3B000BA OOOOOOOO OOOOOOOO 






ooooooooi.5 

0200000 



OOOO 00020007. .00000000. . 

D062 bo'odoob'o oobbdodo" 



38P+ f\dUrW3 »/\ "C4 

w.«^«i— p/ai' — a^oooo, „ 

uuuuuuuu ' \.Tr..^......ol o4AnnAnAJn66?oooB oooooooo 



fto/e^/^<a c^ /^^ .^^^)tn,re^ 



V J200C2C7 80040000 



001009p0_'<459dpb36 OOOOOOOO OOOOOOOO 
" "o63d6obo_ft450JD0 8 E OOOOOCOO OOOOOOOO 

oosoooooji ooy""" 



PIB 2 



S00E2880 8000C6F4 80007000 00006518 



O^/'Z -C.^m*«^ WW ....AR....,..Y 



^ 
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Figure 4.2 Format and contents of any partition communications 

*The address of the connmunications region is in fixed location X'14' — X'17' 
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PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 



(Dec) (Hex) 



8 
10 

12 

23 
24 
32 



36 
40 



44 
46 



48 
52 



00 



08 
OA 

OC 

17 
18 
20 



24 



28 



2C 

2E 



30 
34 



Meaning 



MM/DD/YY or DD/MM/YY either set permanently at IPL time or temporary by the job 

control date statement, or updated every time a GETIME macro is issued when 

time-of-day support is provided. 

Format controlled by BGCOMREG +53. 

(System Configuration Byte, data convention bit 0) 

Address of the problem program area. (PPBEG) 

Address of the beginning of the problem program area. The 16 lower order bits of 
Y (EOSSP) equals Y (PPBEG) 

User area. If seek separation option is specified, bytes 12 and 13 are used at IPLtime 
for the address of the seek address block. 

Use program switch indicator. (UPSI byte) 

Job name set by the job control program from information found in the job statement. 

Address of the uppermost byte available to the problem program, that is either the 
address of the uppermost byte of the partition as determined during processing of the 
ALLOC or ALLOCR macro or statement, or the end address of the area specified by 
the SIZE parameter in the EXEC statement. 

Address of the uppermost byte of the last phase of the problem program fetched or 
loaded. Not filled in when the phase is in the SVA. 

Hilghest ending main-storage address of the last phase among all the phases having the 
same first four characters as the operand on the EXEC statement. For the phase 
$LNKEDT this field is not filled in. The address value may be incorrect if the progranri 
loads any of these phases above or below its link-edited origin address, if the EXEC 
statement has no operand, job control places in this location the highest ending 
address of all programs just link-edited. 

Length of the problem program label area. 

The low order byte identifies the partition (see Appendix B), and equals the 
displacement from the start of the PIB to the start of the PIB of the partition 
(without AP). The PI K from BGCOMREG changes during system operation and 
contains the PIK of the active partition (whichever one is active). The PI K in the 
FnCOMREG remains unchanged. 

End address of virtual storage. 

Machine Configuration Byte (Values set at supervisor generation time) 

Bit 0: Always set to indicate standard storage protect 
1 : 1=Decimal feature (always set) 
2: 1=Floating point feature 

0=No floating point feature 
3: 1=Always set to indicate Physical transient overlap 
4: Always set to indicate standard timer feature 
5: 1=Channel switching device 

0=No channel switching device 
6: 1=Burst made on multiplex channel support 

0=No burst mode on multiplex channel support 
7: Indicates MCH/CCH in system. 
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Displacement 



(Dec) (Hex) 



53 



54 



55 



56 



35 



36 



37 



38 



Meaning 



Systenri Configuration byte 

BitO: 1=DDMMYY 

0=MMDDYY 
1 : 1=Two or more partitions 

0=One partition only supported 
2: 1=DASD file-protect supported 

0=No file-protect support for DASD 
3: 1 = DASDSYSIN-SYSFIL 

0=No DASD SYSIN-SYSFIL 
4: 1=Teleprocessing 

0=No teleprocessing 
5: 1=Two or more partitions 

O=0ne partition only supported 
6: 1=Asynchronous processing 

0=No asynchronous processing 
7: 1=Track Hold 

0=No Track Hold. 



(Date convention bit set at generation time by STDJC) 



This byte contains the standard language translator I/O options (set by STDJC macro) 

1= yes, output object modules on SYSPCH 

1= yes, output source module listings and diagnostics 

on SYSLST 
1= yes, output hexadecimal object module listings on 

SYSLST (compilers only) 
1= yes, output symbol tables on SYSLST/SYSPCH 
1= yes, output symbolic cross-reference list on SYSLST 
1= yes, output diagnostics on SYSLST (compilers only) 
1= 48, input on SYSIPT is 48 or 60 character set 



Bit 0: DECK option 
1: LIST option 

2: LIST X option 



3: SYM option 
4; XREF option 
5: ERRS option 
6: CHARSET option 
7: Reserved. 



This byte contains the standard supervisor options for abnormal EOJ, Relocating 
Loader and Control statement display and the indicator for the presence of the 
ASCI l-EBCDIC and EBCDIC-ASCI I translation tables. 



1= yes, dump registers and storage on SYSLST 
1=partition in wait state, because volume is to be mounted 
1= yes, list all control statements on SYSLST 
1=dummy device search in progress; do not enter ERR 



1= yes. Relocating Loader supported 
1= yes, ASCII supported. 



Job Control byte 

Bit 0: 1= Job accounting Interface (JA) is not supported 
0= Job accounting Interface (JA) is supported 

1 : 1= Return to caller on LIOCS disk open failure 

0= Do not return to caller on LIOCS disk open failure 

2: 1= Job control input from SYSRDR 
0= Job control input from SYSLOG 



Bit 0: 


Always on 


1: 


DUMP option 


2: 




3: 


LOG option 


4: 




5: 


Not used 


6: 


Relocating Load 




option 


7: 


ASM option 
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PARTITION COMMUNICATION REGION 



Cont'd) 



Displacement 



(Dec) (Hex) 



56 



57 



58 



59 



38 



39 



3A 



3B 



1: 



3: 



Job Control byte (. . . . Cont'd) 

Bit 3: 1= Job control output on SYSLOG 

0= Job control output not on SYSLOG 
4: 1= Cancel job 

0= Do not cancel job 
5: 1= Pause at end-of-job step 

0= No pause at end-of-job step 
6: 1= SYSLOG is not a console printer-keyboard or DOC 

0= SYSLOG is a console printer-keyboard or DOC 
7: 1= SYSLOG is assigned to the same device as SYSLST 
0= SYSLOG is not assigned to the same device as SYSLST. 

Linkage control byte 

Bit 0: 1= SYSLNK open for output 

0= SYSLNK not open for output 

1= Update of Second Level Directory and RAS loadlist in progress. 

(Interface between |MAINDIR and supervisor). 
1= Allow EXEC 
0= Suppress EXEC 
1= Catalog linkage editor output 
0= Do not catalog linkage editor output 
4: 1= Supervisor has been updated 

0= Supervisor has not been updated 
5: Reserved 
6: 1 = Update of system CI L in progress. 

(Interface between $MAINDIR and supervisor). 
7: 1= Check automatic condense limits and EOJ. 

(Interface between librarian and job control). . 

Language processor control byte. This is a set of switches used to specify non-standard 
language translator options. The switches within the byte are controlled by job 
control OPTION statements and when set to 1 , override standard options. The 
format of this byte is identical to the standard option byte (displacement 54) with 
one exception: Bit 7 in this byte is used to indicate to LIOCS that the rewind and 
unload option has been specified. 

Job duration indicator byte 

Job in progress 

Job not in progress 

Dump on an abnormal end-of-job condition 

No dump on abnormal EOJ 

Pause at EOJ step 

No pause at EOJ 

Job control output on SYSLST 

Output not on SYSLST 

Job is being run out of sequence with a temporary assignment for SYSRDR 

Conditions for 1 -setting not met 

PCIL is being condensed 

PCI L is not being condensed 

//DATE statement processed for current job 

No //DATE statement processed for current job 

Batch command just issued 

Condition for 1 -setting did not occur. 



BitO: 


1 = 




0= 


1: 


1 = 




0= 


2: 


1 = 




0= 


3: 


1 = 




0= 
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1 = 
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1 = 




0= 
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\..-..*' 



''^ 



V,_y 



Figure 4.3. Key to Communication Region displacement, part 3 of 6 



4.38 Debugging for Programmers, part 2. 



^"""^K- 



PARTITION COMMUNICATION REGION ( Cont'd) 



Displacement 


Meaning 


(Dec) 


(Hex) 


60 


3C 


Binary disk address of the volume label area (label cylinder). 


62 
76 


3El 

4Cj 


Addresses of FOCL, PUB, FAVP, JIB, TEB, F ICL, N ICL and LUB 
(See Figure 4.2) 


78 


4E 


Set to the value nn specified in the LINES= nn parameter of the STDJC macro. 


79 


4F 


The format of the system date contained within this field is determined by the IPL 
program from information supplied in the date convention bit (displacement 53). 
Bytes 85-87 contain the day count. 


88 


58 


Bytes reserved for use by LIOCS. Transient dump programs insert a key to indicate 
to the LIOCS end-of-volume routine, $$BCMT07, that it was called by a B-transient. 


90 


5A 


Address of the first part of the program information block (PIB) table. 


92 


5C 


ID number of the last checkpoint. Byte 92 is also the temporary indicator of file 
protected DASD. Bits 0-6 correspond to channels 0-6. A bit ON means DASDFP for 
that channel. Bit 7 indicates 2321 DASDFP support. Byte 93 is used at IPL time 
by PIOCS - Bit 0: 1 = 3330 file protection 
Bit 1 : 1 = 3340 file protection 


94 


5E 


Job zone for Time of Day. If ZONE=EAST, value is positive; if ZONE=WEST, 
value is negative. 


96 


60 


Address of the disk information block (DIB) table for the partition. 


98 


62 


Reserved. 


100 


64 


Address for PC, IT, and OC option tables. 


104 


68 




106 
108 


6A 
6C 


Key of the program that has internal timer support. The key is the same as the 

PI K for the timer supported partition. If multiple partitions all have timer support it 

is initially X'0010' but may be changed to the PIK of another partition by the 

TIMER command. It is copied into all partition communications regions. If no 

partition has interval timer support, these bytes contain X'OOOO'. 

Reserved. 


110 


6E 


Logical Transient Key (LTK) contains the same value as the PIK (PID) (Displacement 

46) when the logical transient is requested. When the transient area is not in use, 

LTK is equal to zero. The SVC2 routine sets the LTK. (See Appendix B 

for a description of the LTK). 

The SVC1 1 routine resets the LTK, (only significant in BG communication reg.) 


112 


70 


Address of SYSPARM field. 


116 


74 


Address of Job Accounting partition table. 


120 


78 


Address of the Time of Day Clock common area. 


124 


7C 


Address of second part of program information block (PIB) table. 


126 


7E 


Address of PDTABB, table of DTF addresses for MICR support. 


128 


80 


Address of QTAM vector table (IJLQTTAD). 


132 


84 


Address of background communications region. 
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PARTITION COMMUNICATION REGION (. . . Cont'd) 






Displacement 



(Dec) (Hex) 



134 



135 



136 
140 



141 



142 



143 



86 



87 



88 
8C 



8D 



8E 



8F 



Meaning 



Option Indicator byte 

Bit 0: Reserved 

1 : 1 = EU interface active 

0= EU interface inactive 
2: 1= Teleprocessing request 

0= No teleprocessing request 
3: 1 = Supervisor support for tape 

0= Supervisor does not support tape 
4: Reserved 
5: 1= RETAIN support generated 

0= RETAIN support not generated 
6: 1= Linkage to Channel En d Appendage Routine allowed 

0= Linkage to Channel End Appendage Routine not allowed 
7: 1= GETVIS function has been initiated 

0= GETVIS function has not been initiated. 

System Configuration byte 2 and RMSR Open Flag byte 

Bit 0: 1= PCI L supported 

0= PCIL not supported 
1 : TOD supported 
2: 1= PFIX macro supported 

0= PFIX macro not supported 
3: 1= Fetch $$OPEN by SJOBCTLJ 
4: 1= Fetch $$OPEN by SJOBCTLD 
5: 1= Fetch $$OPEN by SJOBCTLJ for WTM 
6: 1= QTAM supported 

0= QTAM not supported 
7: 1= RPS supported 0= RPS not supported 



RMSR OPEN flags 






Pointer to Option table in SYSCOM. Reserved for compatibility reasons. 

Standard Job Control Option byte 

BitO: 1= EDECK Standard Option 
1: 1= ALIGN Standard Option 
2-6: Not used 
7: 1 = ACANCEL standard 

Temporary Job Control Option byte 
Bit 0: 1= EDECK Temporary Option 
1: 1= ALIGN Temporary Option. 
2-5: Not used 
6:1=:SUBLIB = DF 

Temporary Option 
7:1 = ACANCEL 
Temporary Option 

Disk Configuration byte 
Bit 0-4: Not used 

5: 1 = 3340 supported 

= 3340 not supported 
6: 1= 3330 supported 

0= 3330 not supported 
7: Always 1; indicates 2311 and 2314/2319 supported. 

Catalogued Procedure Name. 



c 
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PARTITION COMMUNICATION REGION { Cont'd) 






Displacement 


Meaning 


(Dec) 


(Hex) 


151 


97 


Interface byte for Catalogued Procedures 

Bit 0: 1= Procedure being executed 
1:1= Overwrite processing 
2: 1= Procedure with data 
3: 1 = Overwrite request for Job Control 
4: 1= Insert request for Job Control 
5: 1= Procedure end 
6: 1= SYS LOG procedure 
7: 1= Overwrite request for Supervisor. 




152 


98 


JCL statement name for Catalogued Procedure. 




159 


9F 


SYSIN 81 bytes indicator 

Bit 0: 1= Permanent 81 bytes on SYSRDR 
1:1= Permanent 81 bytes on SYSIPT 
2: 1= Temjborary 81 bytes on SYSRDR 
3: 1= Temporary 81 bytes on SYSIPT 
4-6: Not used 
7: 1=Allow /& for MAINT CATALS. 




160 


AO 


Address of POWER/VS partition control block (If 
this field contains binary 0) 


none exist for the partition 


164 


A4 


POWER/VS flag byte 1 
Bit 0: 1 = POWER/VS accounting supported 
1 : 1= Partition under control of POWER/VS 
2: 1= POWER/VS partition 
3-7: Not used 




165 


A5 


POWER/VS flag byte 2 
Bit 0-7: Not used 
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System cominunication Region (SYSCOM) 



This table is located in the supervisor, immediately after the background partition 
communication region. It contains partition-independent pointers and addresses of 
tables used by the system control program (SCP). The contents of SYSCOM is 
listed in Figure 4,4 parts 1 and 2, displacements are given in hexadecimal from the 
first byte of SYSCOM 



Locating SYSCOM 

Bytes X'80 - 83' of low address storage contain the address of SYSCOM. 

Displacement 



Hex 


00 


04 


08 


OA 


oc 


10 


14 


18 


Dec. 


00 


04 


08 


10 


12 


16 


20 


24 




Address 


Address 


Address 


Address 


Address 


Address 


Address 


Address 




of Error 


of 


of 


of 


of 


of 


of I/O 


of External 




Block 


Attention 


Operator 


Operator 


SYSRES 


Fetch 


Interrupt 


Interrupt 






Exit 


Option 
Cancel 
Exit 


Request 

Cancel 

Exit 


PUB 


Routine 


Routine 


Routine 



Hex 


1C 


20 


24 


25 


28 


2A 


2C 


2E 


Dec 


28 


32 


36 


37 


40 


42 


44 


46 




Address 


Address 


Free 


Address 


Number 


Length 


Number 


Not Used 




of 


of First 


List 


of 


of 


of One 


of 






Logical 


Byte of 


Poi 


Channel 


Channel 


Error 


Partitions 






Transient 


Problem 


nter 


Queue 


Queue 


Queue 








Area 


Program 
Area 






Entries 


Entry 







Hex 


30 


34 


38 


3C 


40 


44 


46 


48 


Dec 


48 


52 


56 


60 


64 


68 


70 


72 




Address 


Address 


Address 


Address 


Flags and 


System 


Address 


Address 




of 


of 


of 


of 


Switched 


Task 


of 


of 




Channel 


CRT 


Seek 


Channel 


(see 


Selection 


Task 


PD Area 




Buckets 


Table 


Address 

Block 

Table 


Control 
Table 


expansions) 


Control 
Field 


Selection 





Hex 


4C 


50 


54 


58 


5A 


50 


60 


Dec 


76 


80 


84 


88 


90 


92 


96 




Address 


Address 


Address 


Key of 


Key of 


Power/VS 


Reserved 




of Track 


of Timer 


of AB 


Task 


Task 


Partition 
if 

Power/VS 
initiated 






Hold 
Table 


Request 
Table 


Table 


Owning 
LTA 


Running 





Hex 


64 


68 


6C 


70 


74 


78 


7C 


80 




Dec 


100 


104 


108 


112 


116 


120 


124 


128 






Address 


Address 


Address 


Address 


Address 


Address 


Address of 


Base 






of 


of 


of 


of 


of 


of PUB 


Job 


Address 






RF 


EUECB 


OLTEP 


RAS 


ASCII 


Owner- 


Account- 


of Page 






Table 


Table 


Bucket 


Linkage 


Translate 


ship 


ing 


IVIanagement 






■ 






Area 


Table 


Table 


Common 
Table 


Routine 




Hex 


84 


88 


8C 


90 


94 


98 


9C 


AO 


A1 


Dec 


132 


136 


140 


144 


148 


152 


156 


160 


161 




Base 


Address 


Address 


Address 


Address 


Address 


Address 


Align- 


Pointer 




Address 


of 


of Line 


of 


of PTA 


of First 


of Task 


ment 


to 




of Channel 


SDAID 


Mode 


VSAM 




System 


Block 


Byte 


RAS 




Program 


Save 


Table 


Comm 




Task 


of 




Task 




Translation 


Area 




Area 




Block 


active 




Block 




Routine 












System 
Task 
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Hex 


A2 


A3 


A4 


A5 


A6 


A7 


80 


84 


88 


Dec 


162 


163 


164 


165 


166 


167^ 


176 


180 


184 




Pointer 


Pointer 


Pointer 


Pointer 


Pointer to 


Reserved 


Not 


Address 


TRTMSK 




to 


to 


to CRT 


to ERP 


PAGEIN 


9 X'OO' 


Used 


of 


pointer 




PMGR 


SUPVR 


Task 


Task 


Task block 






MVCFLD 






Task 


Task 


Block 


Block 














Block 


Block- 
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Hex 


BC 


BE 


CO 


CB 


CC 


CE 


DO 


D4 


D8 


Dec 


188 


190 


192 


203 


204 


206 


208 


212 


216 




Not 


Not 


Reposi- 


Number of 


Length 


Number 


Address 


Address 


Address 




Used 


Used 


tioning 


Error 


of PUB 


of 


of 


of Page 


of Page 








information 


Queue 


Table 


Active 


Segment 


Frame 


Frame 








for 2560/ 


Entries 


in Bytes 


Partitions 


Table 


Table 


Table 








5425 ERP 












Extension 



Hex 
Dec 



DC 


EO 


E4 


E8 


EC 


FO 


F4 


F5 


F8 


FC 


100 


220 


224 


228 


232 


236 


240 


244 


245 


248 


252 


256 


Address 


Address 


Reserved 


Address 


Address 


Address of 


SVA 


Address 


Address of 


Address of 


Pointer to 


of 


of DPD 




of 


of End 


Fetch 


Flag 


of SVA 


System 


RPS LDL 


RPS Sector 


Boundary 
Box 


Table 




VIRTAD 
Routine 


of Real 
Storage 
(Fullword) 


table 


(See 
expansion) 




GETVISarea 


in SVA 


Calculation 
Routine 
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y 



Dec 


Hex 


Description 


64 


40 


Reserved for RMS support on the Models 115 and 125 






X'80' 


RMSR for channel attached devices, tapes and TP devices 






X'40' 


Full RMS support (MCAR/CCH and RMSR) 






X'20' 


MCAR/CCH support 


65 


41 


X'80' 


Initial selection of ErP 






X'40' 


Reserved 






X'20' 


Timer interrupt pending 






X'10' 


MICR Stacker-select active 






X'08' 


Invalid address during fetch 






X'04' 


SIO routine entered after interrupt 






X'02' 


Reserved 






x'or 


IPL in progress 


66 


42 


X'80' 


Initial RAS request 






X'40' 


RAS WAIT request outstanding 






X'20' 


RAS IPL in progress 






X'10' 


Reserved 






X'08' 


POWER/VS supported 






X'04' 


POWER/VS Initialized 






X'02' 


GETREAL for SDAID in progress 






x'or 


Fetch for system task in progress (used by PDAID's) 


67 


43 


Reserved 





LAYOUT OF SYSTEM TASK SELECTION CONTROL FIELD 



244 F4 


SVA Flag 




X'80' Do not test for warm start copy of SVA 




X'40' SDL active 




X'20' No 'Set SVA' or 'Set SDL. allowed 




X'10' Build of SDL in progress 




X'08' SDL overflow 




X'04'l 




X'02' > Reserved 




x'or j 



Dec 


Hex 


Description 


68 


44 


Always zero 


69 


45 


SELECT byte: 

X'OO' No system task active 

X'Or RAS active 

X'02' PMGR active 

X'03' SUPVR active 

X'04' CRT active 

X'05' ERP active 

X'06' PAGEIN active 



Figure 4.5 



SYSCOM Expansion flag bytes. 
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LUB entry 
number for 
first BG 
System Logical 
Unit 



System and 
Programmer 
Logical Units 

I ►SYSRDR 

SYSIPT 

SYSPCH 

SYSLST 

SYSLOG 

SYSLNK 

SYSRES 

SYSSLB 

SYSRLB 

SYSUSE 

SYSREC 

SYSCLB 

SYSVIS 

SYSCAT 

> SYSOOO 

SYS001 

SYS002 



LUB I 
entry | 
number i 



-PUB pointer 



FICL 

■D 



r 



i 



tr 



CO 



a> r- 
OC 

< 



0) "D 

-9 = 

-3 <" 

Z T3 



00 



OE 



I 

-J I 
■ I 



3A 



SYSmax 

SYSRDR 

SYSIPT 

SYSPCH 



LUB entry 
number for 
first programmer 
unit for F1 



I SYSCAT 

I SYSVIS 

I SYSOOO 

!-► SYS001 



t 
SYSmax 



00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 

OE 

OF 

00 



SYSCAT 
SYSVIS 
■> SYSOOO 
SYS001 



i 



SYSmax 



SYSRDR 



00 FF 

00 FF 

01 FF 

02 00 K 



FFFF 



£ 
1 O 



E CN 



E ° 

CO ^ 

a> CO 

2 3 



E ,- 

0) LL 



^ P 



E 
E 

(0 r- 



I— ■ 



r 



.J 



y- 



NICL 

Number of bytes required 
depends on NPARTS 
Number of programmer 
LUBs in appropriate partition 



OE 


1E 


OF 


OF 







BG BG F2 F1 



-J I 



I 



FAVP 



r 



___^ 



PUB 

I entry 
I number 

, — * -♦■00 

01 

02 

03 

04 

i 

OC 
OD 
-•►OE 
OF 
10 
--•'ll 



t 
IB 

^1C 



JIB 

entry 

number 



Temp assignment 
//ASSGN SYSLST, X'lSV 

JIBTAB 



.J 



r-^00 

►01 

02 

03 

04 

OC 
OD 
OE 
OF 
10 
11 



030E00FF 



JIB 

(See Figure 4.12. 



_i 



Device p 
address i 



CHANQ pointer 



►22 
23 



OOOC (00 



PUB (See Figure 4.8.) 

PUB entries for 
channel 



0131 



PUB entries for 
channel 1 



PUB entries for 
channel 2 




CC 8 pointer 



"1 



PUB entries for 
channel 3 



PUB entries for 
channels 4, 5, and 6, 
if supported 



L 



Channel 

Control 

Table 

(See Figure 4.14.) 



If program is virtual, tfiis 
^\ pointer points to ttie 
— S copied CCB, whicti in 

I turn points to ttie copied 

^ CCW block (s). 



Chan 




Chan 1 




Chan 2 




Chan 3 




Chan 4 




Chan 5 




Chan 6 





CCB Copy Block 



CCW Copy Block(s) 



IDAL Block 



(Refer to Chapter 13 
in this Section for a 
description of Channel 
Program Translation.) 



~l 



L. 



00 OE 1C 22 FF FF FF 



FOCL 



X FF Indicates 
that the channel 
Is not supported 



Chan 
Chan 1 
Chan 2 
Chan 3 
Chan 4 
Chan 5 
Chan 6 



Channel Buckets (See Figure 4.1 5.) 

One 24 byte entry for each channel; 

no entry is made for channels not supported. 



Error Recovery Block (See Figure 4.16.) 



Up to 25 entries max. each entry being 44 bytes 



I 



Input/output control system in user problem progran 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in thi 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in th 



Explanation of the figure. 

7776 contents of the tables Indicate the following: 

The system has 3 partitions. 

» Logical unit SYSRDR is assigned to device address OOC. 

SYSCLB is unasslgned. 

SYSLST has a temporary assignment to device address 1. 

Device OOC Is queued and chained, indicating two I/O 

requests for this unit. 
The CCB pointer for the first I/O request points to a 

LIOCS DTF in the user program that is running In real rr, 
The CCB pointer for the second I/O request points to a 

PIOCS CCB and channel program In a user program 

running in virtual mode. 

I/O channels 4, 5, and 6 are not supported by the systerr 

Figure 4.6. The interrelationship between the Supe 
and information blocks, and the user program IOC J 
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PUB pointer 



I 



|- 



v 



._] 



NICL 

Number of bytes required 
depends on NPARTS 
Number of programmer 
LUBs in appropriate partition 



OE 
1 


IE 


OF 


OF 







BG BG F2 F1 



-J I 
I 

I 



FAVP 



r 



__^ 



_ PUB 
I entry 
I number 

, — * -•■00 

01 

02 

03 

04 

i 

oc 

OD 

— »-0E 

OF 

10 

--►11 



t 
IB 

'1C 



JIB 

entry 

number 



Temp assignmen t 
//ASSGN SYSLST, X'131' 

JIBTAB 



.J 



r-^00 
►oi 

02 
03 
04 

OC 
OD 
OE 
OF 
10 
11 



030EOOFF 



JIB 

(See Figure 4.12. 



_i 



21 
|>22 
23 



Device \ 

address i 



CHANQ pointer 



OOOCIOO 



PUB (See Figure 4.8.) 

PUB entries for 
channel 



0131 



PUB entries for 
channel 1 




CCB pointer 



PUB entries for 
channel 2 



PUB entries for 
channel 3 



PUB entries for 
channels 4, 5, and 6, 
if supported 



00 OE 1C 22 FF FF FF 



FOCL 



X FF indicates 
that the channel 
is not supported 



1 



I 



Channel 

Control 

Table 

(See Figure 4.14.) 



If program is virtual, this 
X J pointer points to the 

S copied CCB, which in 

I turn points to the copied 
^ CCWblockIs). 



Chan 




Chan 1 




Chan 2 




Chan 3 




Chan 4 




Chan 5 




Chan 6 





L. 



CCB Copy Block 



CCW Copy Block(s) 



IDAL Block 



(Refer to Chapter 13 
in this Section for a 
description of Channel 
Program Translation.) 



n 



Chan 
Chan 1 
Chan 2 
Chan 3 
Chan 4 
Chan 5 
Chan 6 



Channel Buckets (See Figure 4.1 5.) 

One 24 byte entry for each channel; 

no entry is made for channels not supported. 



Error Recovery Block (See Figure 4.16.) 



Up to 25 entries max. each entry being 44 bytes 



I 



I 



Input/output control system in user problem program area. 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in this Section. 



CCB (Refer to Chapter 5 in this Section.) 



Channel Program (Refer to Chapter 5 in this Section. 



I/O TABLES AND 
INFORMATION BLOCKS 



A 



Logical IOCS 
)> (Refer to Chapter 4 
in this Section.) 



^ 



Physical IOCS 
(Refer to Chapter 4 
in this Section.) 



Explanation of the figure. 

The contents of the tables indicate the following: 

• The system has 3 partitions. 

Logical unit SYSRDR is assigned to device address OOC. 

S YSCL B is unassigned. 

SYSLST has a temporary assignment to device address 131. 

Device OOC is queued and chained, indicating two I/O 

requests for this unit. 
The CCB pointer for the first I/O request points to a 

LIOCS DTF in the user program that is running in real mode. 
The CCB pointer for the second I/O request points to a 

PIOCS CCB and channel program in a user program 

running in virtual mode. 

I/O channels 4, 5, and 6 are not supported by the system. 



Figure 4.6. The interrelationship between the Supervisor I/O tables 
and information blocks, and the user program IOCS. 



Note: All numbers shown are in 

hexadecimal and are 

inserted for illustration purposes only. 
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The LUB table 

This table is built up during system generation by the lOTAB supervisor generation 
macro, accoirding to the BGPGR and FnPGR parameters (where n is the partition 
number). The table has one entry for each logical unit required for the system. 
Each entry is two bytes long and entries are grouped into two classes: 

• System LUBs 

• Programmer LUBs 

There are always 14 system LUBs for each partition on the system. 

By examining the contents of this table you can see the logical units that: 

• Are unassigned or assigned (and, if assigned, to which entry in the PUB table) 

• Have a temporary assignment or an alternate assignment, or indicate that a 
DASD file is opened. 

How to locate: 

Bytes X'4C'— X'4D' in the partition communication regions contain the address 
of the first entry in this table. Label LUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The number of LUB entries for system logical units in the BG System LUB and the 
number of LUB entries for programmer logical units in each programmer LUB is 
stored in the NICL information block. 

NICL, (Number in Class List) 

Byte of this information block contains the number of System LUB entries (for 
DOS/VS, always 14, X'OE'). Byte 1 contains the number of programmer LUBs for 
the BG partition, and the remaining bytes contain the number of programmer LUBs 
for each foreground partition in the system (one byte per partition). 
The total number of bytes in the NICL is equal to the number of partitions in the 
system plus one. 

How to locate 

Bytes X'4A' — X'4B' of the partition comregs contain the address of the first entry 

in this information block. Label NICL in the supervisor hsting identifies the 

address of the first byte of this information block. 

A pointer to the first entry in the LUB table and a pointer to the first LUB entry 

for the programmer LUBs for each partition is stored in the FICL information 

block. 

FICL, (First In Class List) 

Each byte of this information block points as a displacement index to the 
beginning of a LUB sector. 

Byte to the first LUB entry, and the remaining bytes to the first LUB entries for 
each programmer LUB of each partition. The total number of bytes in the FICL is 
equal to the number of partitions in the system plus one. 

How to locate: 

Bytes X'48' — X'49' of the partition comregs contain the address of the first entry 
in this information block. Label FICL in the supervisor listing identifies the 
address of the first byte of this information block. 

Figure 4.7 (opposite) shows the format and contents of the LUB table, and expands 
one entry in order to explain its contents. The figure also shows the relationship 
between the LUB, NICL, and FICL. 
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O 



JF% 

^^,1^ 



Number in 
Class List 
(NICL) 



SYS 



BG 
F4 



F3 
F2 
F1 



LUBTAB 



First in 
Class List 
(FICL) 



BG 

System LUBs 



BG 

Programmer LUBs 



F4 

System LUBs 



F4 

Programmer LUBs 



F3 

System LUBs 



F3 

Programmer LUBs 



F2 

System LUBs 



F2 

Programmer LUBs 



F1 

System LUBs 



F1 

Programmer LUBs 



SYS 



BG 
F4 



System Lubs 



LUB Table for any 
Partition 



Programmer Lubs 



SYSRDR 

SYSIPT 

SYSPCH 

SYSLST 

SYSLOG 

SYSLNK 

SYSRES 

SYSSLB 

SYSRLB 

1) SYSUSE 
SYSREC 
SYSCLB 
SYSVIS 
SYSCAT 
SYSOOO 
SYS001 
SYS002 
SYS003 
SYS004 

2) SYSnnn 



I/O TABLES AND 
INFORMATION BLOCKS 



-Points to first PUB and PUBOWNER 
1 -Points to second PUB and PUBOWNER 
10 -Points to third PUB and PUBOWNER 



11111110— Ignore, assigned ignore 
11111111 - Null Pointer, the LUB is unassigned 
When a logical unit is assigned, the system inserts a pointer 
to the PUB for the physical device specified. 

















































































=s== 







ByteO 


Byte 1 


PUB Pointer 


JIB Pointer 



1 ) SYSUSE may be called SYSCTL in error recovery messages. 

2) Since there are 14 system LUBs for each partition, 

the maximum number of Programmer LUBs is as follows: 

When number of partitions (NPARTS) = 1:241 

When number of partitions (NPARTS) = 2:227 

When number of partitions (NPARTS) = 3:213 

When number of partitions (NPARTS) =4:199 

Whea number of partitions (NPARTS) =5:185 



JIB Index (Multiply by 4 = Displacement into JIB Table) or 
X'FF' = Null Pointer, no JIB for this LUB. 

A LUB has a JIB pointer in three situations: 

1 . The logical unit is temporarily assigned. 

2. The logical unit assignment is alternate (ALT). 

3. A DASD file (except a system I/O file on disk) is 
opened (DASD file protect only). 



o 



Figure 4.7. The LUB table. 

The figure illustrates the format and contents of one entry and shows its relationship to the 
NICL and FICL information blocks. 
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The PUB table 

This table is built up during system generation by the lOTAB supervisor genera- 
tion macro and each DVCGEN macro fills one PUB entry in the PUB table. 

By examining the contents of this table you can see both the physical address of 
each I/O device attached to the system and which devices are queued in the 
CHANQ. In conjunction with the contents of the LUB and JIB, you can ascertain 
the status of an I/O request for any logical unit. 

The number of bytes in the PUB table (its size) is determined during system 
generation, although the operator can ADD or DELETE I/O devices during IPL. 
The PUB is divided into seven parts, each part containing the I/O devices attached 
to one of the seven channels. The first entry in the PUB belongs to the I/O device 
with the highest priority on channel 0. A pointer to the first PUB entry for each 
channel on the system is stored in the FOCL information block. 

How to locate: 

Bytes X'40' — X'4r of the partition communication regions contain the address 
of the first entry in this table. Label PUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The figure below shows the format and describes the contents of an entry in the 
PUB. Figure 4.9 (opposite) details a PUB entry to bit level. 



PUBTAB 



Channel 
PUBs 



Channel 1 
PUBs 



Job Control Flags 
Channel Scheduler Flags 

Device Type 

TEB Pointer 
Retry Counter 
Unit 



n 



Channel 6 
PUBs 



FF 



PUB-table 
delimiter 



PUBEND 



-Channel Queue Pointer 
- Channel 

Device Characteristic Code 
or SAB Pointer 



Figure 4.8. Format and contents of an entry in the PUB 



FOCL (First on Channel List) 

Byte of this information block points as a displacement index to the first PUB 
entry for the I/O device attached to channel 0, and byte 1 points to the first 
PUB entry for channel 1. The remaining five bytes point to the first entries in 
the PUB belonging to channels 2 to 6. X'FF' indicates that the associated channel is 
not supported on the system. 



How to Locate: 

Bytes X'3E' - X'3F' of the partition communication regions contain the address 
of the first entry in this information block. Label FOCL in the supervisor listing 
identifies the address of the first byte of this information block. 
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Byte 0: Channel number. (Hex 0-6, FF = NULL) 

Byte 1 : I/O device unit number 

Byte 2: Hex 0, 1, 2, points to the first channel queue entry for this device. 

Byte 3: If device is a 2495 Tape Cartridge Reader and TEBs are specified, this 

byte is a TEB pointer (Hex 1 , 2. 3, ). Otherwise, this byte is a ERP retry counter. 

Byte 4: Device type code. See Figure 4.10, parts 1 through 3. 

Byte 5: SS of the MODE= parameter in the DVCGEN macro for tape unit (See Section 2). 
For the Models 115 and 125 ICA line, this byte contains the displacement index of 
the entry in the Line Mode Table (LMT). The address of the LMT is contained 
in bytes X'SC - X'8F' of SYSCOM. 

For DASD with seek separation, this byte is used as the SAB Pointer. 
With Track Hold but not seek separation supported, this byte contains 
a pointer to the Track Hold Table entry or X'FF' (with both SKSEP and 
TRKHLD specified, the track hold pointer is found in the SAB entry). 

For MICR type devices/this byte indicates which external interrupt line 
is in use. 

For a 3705 Communications Controller, this byte contains the type number 
of the Channel Adapter. 

For 2560 or 5425 

Bit 0: 1= Repositioning required 

1 : 0= SYSPCH temporarily assigned to hopper 1 

1= SYSPCH temporarily assigned to hopper 2 
2: 0= SYSIPT temporarily assigned to hopper 1 

1= SYSIPT temporarily assigned to hopper 2 
3: 0= SYSRDR temporarily assigned to hopper 1 

1= SYSRDR temporarily assigned to hopper 2 
5: 0= SYSPCH permanently assigned to hopper 1 

1= SYSPCH permanently assigned to hopper 2 
6: 0= SYSIPT permanently assigned to hopper 1 

1= SYSIPT permanently assigned to hopper 2 
7: 0= SYSRDR permanently assigned to hopper 1 

1= SYSRDR permanently assigned to hopper 2. 

Byte 6: Channel Scheduler Flags 

Bit 0: 1= Device busy 

1 : 1 = Switchable device 

2: 1= EOJ for SYSRDR or SYSIPT 

3: 1= I/O error queued for recovery 

4: 1= Operator intervention required 

5: 1= Device End posting required 

6: 1= Burst mode or overrunnable device on byte MPX channel 

7: 1= 7-track tape unit. 

Byte 7: Job Control Flags 

Bit 0-4: Standard MODE assignment for 7-track tape (all ones 
if not tape, all zeros if device is down) 

Bit 5: 1 = DASD device with Rotational Position Sensing (RPS) feature 

Bit 6-7: B'11' (both on)= Headqueue in progress 
B'01 ' = Headqueue requested. 



^%. 



Figure 4.9. 



Note: A null is generated for each device to be supported by the supervisor. Standard physica/ 
unit assignments are made to the PUB table at supervisor generation time. 
PUBs are ordered by channel and priority within a channel. 

An entry in the PUB Ownership Table is associated with each entry in the PUB Table, 
if the supervisor has been generated to support multiprogramming. 

Explanation of the contents of an entry in the PUB table 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


2400T9 


9-track Magnetic Tape 
Tape units 


50 




2400T7 


7-track Magnetic 
Tape units 


50 




341 0T9 


9-track 3410 Magnetic 


53 






Tape units 




Magnetic Tape devices 


3410T7 


7-track 3410 Magnetic 
Tape units 


53 




3420T9 


9-track 3420 Magnetic 
Tape units 


52 




3420T7 


7-track 3420 Magnetic 
Tape units 


52 




2495TC 


2495 Tape Cartridge 
Reader 


51 


Tape Cartridge Reader 


1442N1 


1442N1 Card Read Punch 


30 




2520B1 


2520B1 Card Read Punch 


31 




2560 


2560 Multifunction Card 


33 






machine 




Card Read Punches 


2596 


2596 Card Read Punch 


30 




3525RP 


3525 Card Punch (with 
optional read feature) 


32 




5425 


5425 Multifunction Card 
Unit 


34 




2501 


2501 Card Reader 


10 




2540R 


2540 Card Reader 


11 




3504 


3504 Card Reader 


12 


Card Readers 


3505 


3505 Card Reader 


12 




1540P 


2540 Card Punch 


21 




2520B2 


2520B2 Card Punch 


20 




1442N2 


1442N2 Card Punch 


22 


Card Punches 


2520 B3 


2520B3Card Punch 


20 




3525P 


3525 Card Punch 


23 




1403 


1403 Printer 


40 




1403U 


1403 Printer with DCS 
feature 


42 




1443 


1443 Printer 


41 




2260(local) 


1053 Printer with 2848 
Control Unit. MODE 
operand must be entered 
as X'01 ' 


CO 




3203 


3203 Printer 


4A 




3211 


3211 Printer 


43 


Printers 


3277 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit. MODE 
operand must be entered 
as X'01 • 






3277B 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit, attached 
in burst mode to a multi- 
plexer channel. MODE 
operand must be entered 
as X'01 ' 






5203 


5203 Printer 


4C 




52030 


5203 Printer with 
UCS feature 


4D 





■\__ 



■v^' 



Figure 4. 1 Device Type Codes, part 1 of 3 



4,50 Debugging for Programmers, part 2. 



Section 4, Chapter 3 



Card 
Code 


Actual IBM Device 


Device - 
Type X'nn' 


Device Type 


1050A 


3210, 3215 Console 
Printer Keyboards 


00 


Printer-Keyboards 


125D 
125DP 


Models 115 and 125 Integrated 

Video Display Unit 

Models 115and 125 Integrated 

Video Display Unit 

with 5213 Console Printer 

attached 


B2 
B2 


Video Display Unit 


UNSP 
UNSPB 


Unsupported device 
Unsupported device 


FF 

FF 


Unsupported. No burst mode 
on multiplexer channel 
Unsupported with burst 
mode on multiplexer 
channel 


2311 
2314 

2314 
2321 
3330 

3340 

3340 

3340 


231 1 Disk Storage device 

2314 Direct Access 

Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330-1 , 3330-2, or 333-1 

Disk Storage 

3340 Disk Storage 

(general) 

3340 Disk Storage 

with 3348 Mod 35 

3340 Disk Storage 

with 3348 Mod 70 


60 
62 

62 
61 
63 

68 

69 
6A 


DASD 


1419 

1419 

1419 

1419P 

1419S 


1255 Magnetic Character 

Reader 

1259 Magnetic Character 

Reader 

1419 Magnetic Character 

Reader 

1419 Dual Address Adapter 

Primary Control Unit 

1419 Dual Address Adapter 

Secondary Contr. Unit 


72 
72 
72 
73 
74 


MICR- Magnetic Ink 
Character Recognition 
devices 


2701 

A 
2702 I 

D 
2703 

2703 
2703 


2701/2715 Data Adapter 
Unit 

2702 Transmission Control 
Unit 

2703 Transmission Control 
Unit 

Integrated Communications 
Adapter (Models 125 and 135) 
3705 Communications 
Controller in Emulation 
Mode 


DO 
D1 

D2 

D2 
D2 


Teleprocessing lines 

A= SADO comm'd 
B= SAD1 comm'd ." 
C=SAD2 comm'd ^"''^'''^S 
D=SAD3 comm'd *^^ ""^ 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


1017 
2671 


1017 Paper Tape Reader 
with 2826 Control Unit 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 



I/O TABLES AND 
INFORMATION BLOCKS 



Figure 4.10 
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Card 
Code 


Actual IBM Device 


Device- 
Type X'nn' 


Device Type 


1018 


1018 Paper Tape Punch 
with 2826 Control Unit 


79 


Paper Tape Punch 


1419 

1419P 

1419S 


1270 Optical Reader/ 

Sorter 

1275 Optical Reader/ 

Sorter Primary Control Unit 

1275 Optical Reader/Sorter 

Secundary Control Unit 


72 
73 
73 


Optical Readers 


1287 
1288 
3881 
3886 

3540 


1 287 Optical Reader 

1 288 Optical Page Reader 
*3881 Optical Mark Reader 

3886 Optical Character 

Reader 

3540 Diskette I/O unit 


77 
77 
11 
7C 


Optical Readers 
DISKETTE 


2260 
3277 
(local 3270) 

3277 B 
(local 3270) 


2260 Display Station 
3277 Display Station; 
MODE operand need not 
be entered 

3277 Display Station; 
attached in burst mode to 
a multiplexer channel. 
MODE operand need not 
be entered 


CO 
BO 

BO 


Display Stations 


7770 


7770 Audio Response Unit 


D3 


Audio Response unit 



"h..^ 



*Note: The logical unit name SYSIN cannot be assigned to a 3881 



Figure 4.10 Device Type Codes, part 3 of 3 
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PUBOWNER (PUB ownership) 

An area in the supervisor is always reserved for this table. The number of entires 
is equal to the number of entries in the PUB, and each entry is two bytes long. 



I/O TABLES AND 
INFORMATION BLOCKS 









By examining the contents of this table in conjunction with the associated entry in 
the PUB, you can identify the partition using a particular I/O device, for example, 
when conflicting assignments are thought to be the cause of a system malfunction. 



How to locate: 

Bytes X'78' - X'7B' of SYSCOM contain the address of the first entry in this 
table. Label PUBOWNER in the supervisor listing identifies the address of the 
first byte of this table. The Figure below shows the format and describes the 
contents of an entry in the PUBOWNER. 



PUBOWNER 






1 



Byte 0: 



Byte 1 



Bit Reserved 

1 1 = waiting for volume to be mounted 
2-7 Reserved 
Identifies the partition that owns the PUB according to following table: 



Flag 


Partition owning PUB if number of partition is: 




2 


3 


4 


5 


x'or 

X'02' 
X'04' 
X'08' 
X'10' 


BG 
F1 


BG 
F2 
F1 


BG 
F3 
F2 
F1 


BG 
F4 
F3 
F2 
F1 



Notes: The number of entries in the PUB Ownership table is equal to the 

number of entries in the PUB table. Associated with each PUB entry 
is an entry in the PUB Ownership table. 



Figure 4. 1 1 Contents of an entry in the PUBOWNER. 

The relationship between the PUB, the PUBOWNER, and the FOCL is shown in Figure 4.6 
at the beginning of this Chapter. 
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The JIB (Job Information Block) 

An area in the supervisor is reserved for this information block during system 
generation by the JIB parameter of the lOTAB macro. This information block 
records any changes to the standard or permanent assignments made by the 
// ASSGN job control statement. Extent information is also recorded in the JIB 
when the supervisor supports the DASDFP feature. 

By examining the contents of an entry in the JIB and its associated LUB, PUB, 
and PUBOWNER entries you can identify the logical units that are temporarily 
assigned, the address of the I/O device, and the partition using the device. Useful 
information can also be obtained from the JIB about DASD extents (DASDFP only), 
for example, when it is not certain why the message INVALID SEEK ADDRESS 
is printed during the execution of a particular job. 



m ^1 



How to locate: 

Bytes X'44' — X'45' of the partition communication regions contain the address of 
the first entry in this information block. Label JIBTAB in the supervisor listing 
identifies the address of the first byte of this information block. 

Entries in the JIB are made: 

• when a temporary assignment is made 

• by alternate tape assignments 

• by DASD extent information (when the file protect feature is supported 
by the supervisor.) 

The next available JIB entry is recorded in the FAVP. 



FAVP (First Available Pointer) 

This is a one-byte pointer to the next available JIB entry. It contains a hexadecimal 
displacement from the first entry in the JIB. If it contains X'FF', no more entries 
in the JIB are available. 

How to locate: 

Bytes X'42' — X'43' of the partition communication regions contain the address 
of this pointer. Label FAVP in the supervisor listing identifies the address of this 
one-byte pointer. 

Figure 4.12 (opposite) illustrates the format and contents of a JIB entry. Its 
relationship to the LUB and PUB is indicated in Figure 4.6. 



o 
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^ik,u*»' 






1 


2 


3 



/ 



\ 



/ 



Number of entries (length of JIB table) 
is determined at supervisor generation 
time 



o 



Note 1: Only when file-protect on DASD. 

Note 2: Two JIB's are required for a 232 1/3330/3340 extent; one for lower 

limit and one for upper limit. The lower limit defining JIB must 

be chained to the upper limit defining JIB. 

For 2321, byte 1 of this JIB contains the subcell number times 

10 plus the strip number in binary. 



Byte(s) 


s. 
Description 


0-1 (Contents 
depends on the bit 
setting in byte 2) 


Bit setting 
Byte 2 


Contents 


Bit 0= 1 


LUB entry of stored standard assignment. 




Stored standarc 


(PUB and JIB pointer) 




assignment 




Bit 1= 1 


ByteO: PUB pointer 




Alternate 


Byte 1 : X'OO' 




assignment 




Bit 2= 1 


Byte 0: Cylinder lower limit 




2311/2314/ 


Byte 1 : Cylinder upper limit 




2319 Extent 


See Note 1 


Bit 3= 1 


For 2321 : 




2321^330/3340 


Lower limit (Cell or combined 




Extent 


subcell and strip), or 

Upper limit (Cell or combined 
subcell and strip) 

For 3330/ Cylinder lower limit, or 

3340: Cylinder upper limit (One cylinder 
number of the 3330/3340 
uses two bytes) 

See Notes 1 and 2 


2 


Meaning if bit = 1 : 




Bit 0: Stored standard assignment 




Bit 1 : Alternate assignment 




Bit 2: 231 1/2314/2319 extent 




Bit 3: 2321/3330/3340 extent 




Bit 4: The alternate assignment indicated in bit 1 is permanent. 




This bit is also on when one of the extent indicators 




(bit 2 and bit 3) is on. 




Bit 5: Catalogued procedures processing 




Bit 6/7: Reserved. 


3 


Chain byte 




Contains the displacement index of the next JIB. 




X'FF' defines the end of the chain. 



o 



Figure 4,1 2 Explanation of the contents of an entry in the JIB. 
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CHANQ (Channel Queue) 

The area in the supervisor reserved for this table is determined during system 
generation by the CHANQ parameter of the lOTAB macro. 

This table is used by the supervisor to schedule I/O operations. An entry is made 
in the channel queue v^henever a request is made for an I/O operation, and the 
entry remains in the queue until the operation is completed. Thus, at any point 
in time, the queue will consist of entries for I/O operations in progress and I/O 
operations waiting for initiation. Whenever an I/O event completes, the queue is 
examined to see if an operation is waiting for the device, and if so, .the operation 
is initiated. 

Each entry made in this table occupies an eight-byte field. Entries are pointed to 
by a CHANQ POINTER contained in byte 2 of any PUB entry owning a device 
waiting for an I/O operation to complete. 

By examining the contents of this table together with the contents of the PUB 
table you can determine the following: 



Whether a particular I/O device is waiting for an I/O operation to be completed. 
The reason for an uncompleted operation. 

How many I/O requests have been made for a particular device (by looking at 
the CHAIN byte). 

The CCB (Command Control Block) address and, therefore, the channel 
program and I/O area used by a particular device. (The CCB and channel 
program are described in Chapter 5 in this Section.) 
The identity of the task that requests an I/O operation for a particular 
device. 

Whether the channel queue is completely occupied (probably causing a soft 
wait state). 



1> 



How to locate: 

Bytes X'25' - X'27' of SYSCOM contain the address of the first entry in this table. 
Label CHANQ in the supervisor listing identifies the address of the first byte of 
this table. 

The number of channel queue entries occupied at any given point in time depends 
on the I/O activity in the system. A one-byte pointer (FLPTR) points to the next 
eight-byte field in this table that is free for use. 



( 



FLPTR (Free List Pointer) 

This one-byte pointer contains the hex displacement from the beginning of the 
channel queue table to the next available CHANQ entry. When the channel queue 
is full, it contains X'FF'. 



How to locate: 

Byte X'24' of SYSCOM contains the address of this information byte. Label 
FLPTR in the supervisor listing identifies the address of the first byte of this 
information byte. 

For a detailed description of the operation of the CHANQ and FLPTR refer to the 
DOS /VS Supervisor Logic manual. 

Figure 4.13 (opposite) shows the format and describes the contents of the CHANQ 
table, and Figure 4.6 illustrates the relationship between the PUB, CHANQ, and 
FLPTR. 



\J 
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CHANQ 



FLPTR 






PUB * 
byte 2 
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Task requestor Identification 
LUB Displacement 

LUB Identification 



Requestor Identification ■ 



B 



Chain byte 
CCB address 
I 



/ 



X 



\ 



The length of the queue is determined 
at supervisor generation time 



/ 



/ 



/ 



\ 



\ 






Byte 0: 

Bytes 1-3: 
Byte 4: 



Byte 5: 



Byte 6: 



Byte 7: 



\ 



\ 



Contains the displacement within the channel queue of the next entry in the free 
list or in the list for a specific device, or X'FF' when it is the last entry in the free 
list or a device list. 

Contains the CCB address for the specified device. 

Contains a code identifying the task making the I/O request. The one-byte entry 
indicates to which task the CCB belongs, and is in the form X'nk' where: 
n = user storage protection key. (Attention or system task = 0, BG task = 1 , 
FG tasks = 2-5 depending on the number of partitions.) 
k = f or Attention and all user tasks. 
1 for RAS 



2for PMGR 
3for SUPVR 

4 for CRT 

5 for ERP 

6 for PAGEIN 



nK = FF for any unused channel queue entries. 



If the I/O request is from a subtask, this byte does not identify the subtask, but 
the partition. See Appendix B for an explanation of the REQID. 

Contains pointer (displacement index) to the entire LUB table identifying the 
logical unit making the I/O request. This is doubled to get the actual displacement 
into the full LUB table. 

Contains X'FF' if the LUB is a programmer class, or the displacement within the 
partition LUB if it is a system class. 
(Not used by a non-MPS Supervisior.) 

Contains the displacement within the PIB table of the PIB of the task requesting 

I/O, or X'FF' when the channel queue entry is in the free list. 

(Not used by a non-MPS Supervisor.) See Appendix B for an explanation of 

theTKREQID. 



*Notes: FLPTR: The free list pointer contains tfie displacement within the channel 
queue of the first entry in the free list of X'FF' when the channel queue is 
full. Byte X' 24' of the System Communication Region (SYSCOM) contains 
the address of the Free List Pointer. 
Label FLPTR identifies the location of the pointer (1 byte). 

PUB byte 2: The PUB channel queue pointer contains the displacement 
within the channel queue of the first entry for a specific device. 



o 



Figure 4. 1 3. Explanation of the contents of an entry in CHANQ. 
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Channel Control Table. 

This table contains a code identifying the channel types attached to the system. 
There is one entry for each channel attached, and each entry is two bytes long. 

No system generation macro is required to reserve an area in the supervisor for this 
table; information is entered into it by the STORE CHANNEL ID instruction during 
IPL. 



How to locate: 

Bytes X'3C' - X'3F' of SYSCOM contain the address of the first entry in this 
table. Label CHNTAB in the supervisor listing identifies the address of the first byte 
of this table. 

Figure 4.14 (opposite) Hsts the meaning of the code contained in byte of this 
table; byte 1 is always zero. 



Channel bucket 



This information block is always generated in a supervisor. Each channel attached 
to the system owns a 24-byte field in this information block, which records the 
contents of the I/O registers (general registers 1 , 2, 3, and 4) and a pointer to the 
PIE (Program Information Block) for the last I/O started on each channel. 

Its size, or the number of bytes reserved for this information block, is always 
sufficient to allow a 24-byte field for each of the 7 channels, whether attached to 
the system or not. 

By examining the contents of this block, information relating to the last I/O started 
on any attached channel can be obtained. 

Similar information can be obtained by examining the contents of the PUB, CHANQ, 
and FOCL, but the channel bucket formats the information and, in addition, 
contains a pointer to the PIB. Information in the PIB allows more details about 
the task issuing the last START I/O instruction to be obtained. (The PIB is 
described in chapter 8 in this Section.) 



\ 



How to locate: 

Bytes X'30' - X'33' of SYSCOM contain the address of the first entry in this 
information block. Label REGSAV in the supervisor listing identifies the address 
of the first byte in this information block. 

Figure 4.15 (opposite) shows the format and contents of an entry made in the 
channel bucket for a system. 



C 
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CHNTAB 


Channel 


Channel 1 


Oiannej 2 


Channel 3 


Channel 4 


Channel 5 


Channel 6 
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1 



\ 



\ 



\ 



/ 



\ 



\ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 




\ 

\ 


Byte 0: 
Byte 1 : 


X'10' = Byte Multiplexer Channel 

X'1 1 ' = Byte Multiplexer Channel with burst mode support 

X'13' = Byte Multiplexer Channel running in burst mode 

X'OO' = Selector Channel 

X'80' = Channel not operational or not present in the system 

X'20' = Block Multiplexer Channel 

Always zero 





Figure 4.14. Explanation of the contents of the Channel Control Table 



O 



REGSAV 



/ 



1 1 1 1 — r 

II III 



\ 






I Bytes 




3 4 



7 8 



11 12 



15 16 



19 20 



I 
23 



Address of first 
PUB on Channel 


CCB Pointer 


Device Address 


PUB Pointer 


Channel Queue 
Pointer 


FIB Pointer 



Notes: 1 A channel bucket contains information related to the last I/O started on the channel. 

2 The number of channel buckets in a system equals the number of I/O channels in the system. 

Figure 4.15 Contents of the Channel Bucket 
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Error Recovery Block and Error Queue 

Real storage area is reserved in the supervisor for the error recovery block during 
system generation by the ERRQ parameter of the FOPT macro. 

The block is used by error queue entries that are built up by the supervisor in the 
event of an I/O device error during program operation. 

Data recorded in an error queue entry is used by both the ERP (Error Recovery 
Procedure) and RMSR (Recovery Management Support Recorder) routines. 

Each error queue entry is 44 bytes long (hex 2C), and the number of entries 
determined by the ERRQ parameter can be between 3 and 25 for a supervisor not 
supporting multiprogramming, or between 5 and 25 for a supervisor supporting 
multiprogramming. 

On the occurrence of an I/O device error that can not be corrected by hardware or 
software error recovery, a message is printed on SYSLOG. The message may require 
operator response or action, and contains data recorded in the error queue. An 
example of this type of message is: 

BG 0P47A UNX INTERV SYS003=2A1 

CCSW=021 000B49002000000 CCB=00B440 
SNS=40200004024024 1 00000000000892 B 1 6 1 4020 1 0200 1 AO0 1 






If no message can be printed because of the severity of the error, for example, a 
hard wait state, data recorded in the error queue should be analyzed in a dump 
output. 

By examining the contents of the error queue the following information can be 
obtained about any I/O device error recorded in the queue: 

• The status of the I/O device and the last CCW issued. 

• The active entries, if any (X'OT in byte 10). 

• The address of the associated PUB entry, from which the device address 
can be found. 

• The message code. (This code may refer to a DOS/VS message. For example, 
code 08 refers to device error recovery message 0P08A. The reason for the 
error and possible solutions are listed in DOS/VS Messages.) 

• The address of the associated CCB, from which the address of the channel 
program and I/O area used in the operation can be located. 



1 



.J/ 



How to locate: 

Bytes X'OO' - '04' of SYSCOM contain the address of the first byte in this 
information block. Label ERBLOC in the supervisor listing identifies the address 
of the first byte of this information block. 

Figure 4. 1 6 (opposite) illustrates the format and describes the contents of an error 
queue entry. 
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Name of phase 
to be fetched 
(always begins 
^^ABERRA) 



8 



Branch address 
to retry the 
the failing 
operation 



10 



11 



Branch address 
to ignore the 
error 



12 



13 



Branch address 
to cancel the 
task 



14 



15 



Return address 
for A-transient 



First error queue entry 



V_ 



J 



ERROR 
QUEUE TABLE 

ERRQ1 



V 

The A-transient loads one of these address in 
register 14 before branching to the return address 
(see bytes 14-15). 



Flag byte 



PUB address 







10 



12 



1516 



-Message code 



Disk seek address 



19 20 



csw 










CCB 
Address 


Sense data or 
Altern. entry name 



/ 



/ 



/ 



/ 



/ 



\ 



\ 



\ 



\ 



y_ 



o 



o 



Bytes 0- 7: 
Bytes 8- 9: 
Byte 10 



CSW 

Address of PUB for device in error. 



Flag byte: 



BitO 
1 
2 
3 
4 
5 
6 
7 



1= No record found on DASD 

1= Intervention required 

1= Passback (Set by device ERP) 

1= Allow ignore 

Not used 

1= Allow retry 

Not used 

1= Active entry. 



Byte 1 1 



Bytes 1 2-1 5 
Bytes 1 6-1 9 
Bytes 20-43 



Message code: may refer to a device error recovery message generated 
by physical IOCS. (See DOS/VS Messages manual.) 



This location may contain one of the following: 

X'E2' = The error is recoverable. 

X'AE' = A record is to be recorded on the system recorder file for SVC44 

or a BTAM appendage routine, and a Physical Transient is to be fetched 

(last two characters of phasename are in bytes 20-21 ). 

Disk seek address 

Address of CCB 

Sense data: The number of sense bytes generated depends on the options 
specified; the minimum is 24 bytes. 



Alternate entry name: if byte 11 contains X'AE', bytes 20-21 contain the last 
two characters of the phase name of the Physical Transient to be fetched for 
SVC 44 (A3) or BTAM (A5). 

X'AF' in byte 22 indicates that the 1/0 area associated with an alternate entry has 
been fixed temporarily 



Figure 4.16. Explanation of the contents of the Error Block and an entry in the Error Queue 
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The data management facilities of DOS/VS are provided for by a group of routines 
collectively referred to as input/output control system (IOCS). A distinction is 
made between two types of routines: 

1. Physical IOCS (PIOCS). The physical unit I/O routines included in the 
supervisor. 

2. Logical IOCS (LIOCS). The logical unit I/O routines linked with the user's 
problem program. 



Physical IOCS 

Physical IOCS controls the actual transfer of data between the external medium 
and real storage. It performs the functions of initiating the execution of channel 
commands and handHng associated I/O interrupts. Physical IOCS consists of the 
following routines: 

• Start I/O routine 

• I/O interrupt routine 

• Channel scheduler 

• Device error routines. 



Logical IOCS 

Logical IOCS performs the functions a user needs to locate and address a logical 
record for processing. A logical record is one unit of information in a file of like 
units, such as one employee's record in a master payroll file, one part number in an 
inventory file, or one customer account record in an account file. One or many 
logical records may be included within one physical record, such as a physical tape 
record (gap-to-gap). The term logical IOCS refers to the routines that perform the 
following functions: 

• Blocking and deblocking records 

• Switching between I/O areas when two areas are specified for a file 

• Handling end-of-file and end-of-volume conditions 

• Translating American National Standard Code for Information Interchange 
(ASCII) into Extended Binary Coded Decimal Interchange Code (EBCDIC) 
on input, and EBCDIC into ASCII on output 

• Checking and writing labels. 

A user's problem program normally uses LIOCS for file processing (this applies 
also to programs using POWER and VSAM files). LIOCS uses PIOCS to perform 
the data transfers. Figure 4.17 (opposite) illustrates the relationship between LIOCS 
and PIOCS using the GET macro instruction in a user program. 



•4 V 
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o 
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PROBLEM 
PROGRAM 




LOGICAL 
IOCS 




PHYSICAL 
IOCS 




I/O 
DEVICE 




Provide a new 
logical record from 
a physical block in 
the I/O area 

1 (deblock) 


Determine channel 
and: 

a) If channel is not 


. Start device 

1 

Data transfer 

\ 

I/O complete 


Issue READ "" 

request (refer 

to the file 

description 

elsewhere 

in the program). 










to the 
problem program, 

OR 
If actual input is 
required (new 


block), issue a 
physical read 
request (EXCP. 






AND ^ 

WAIT 

1 

When I/O is com- 
plete, provide the 
first (or only) 
logical record from 
the neyv block in 
the I/O area to the 










b) If channel is busy, 
place request into 
channel queue and 
return to LIOCS. 






(Supervisor will 
retry later.) 


♦ 

When I/O is com- 
plete, return to 
LIOCS via interrupt 






Next instruction 
after READ 
request. 




program. 








handling routine 
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Figure 4. 1 7 Example of LIOCS and PIOCS interrelationship. 



Explanation of Figure 4.17: 

Logical IOCS makes a request to physical IOCS to start an I/O operation by means 
of the EXCP macro instruction. From information in the CCB, physical IOCS 
determines the channel for which the request was made and places the request on 
a queue for that device. If the channel(s) or device is not busy, the I/O is started 
and control returns to the problem program. If the channel is busy, control 
returns to the supervisor task selection routines, but the I/O request waits in the 
channel queue. When the request reaches the top of the channel queue, the I/O 
is started. 

Control returns to the program requesting the I/O unless there was an error 
condition detected on the START I/O (SIO) instruction. The problem program 
normally continues processing until it requires that the requested I/O operation 
be complete (either the information being read into real storage is needed, or the 
output area must be freed on an output operation). At this time, the WAIT macro 
causes the now waiting task to be removed from task selection until the proper 
interrupt is processed for this device by the supervisor. 
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Using PIOCS and LIOCS Macro Instructions. 



By use of macro instructions you can create, access and maintain files at both 
physical and logical IOCS levels. Through these macro instructions, the user can 
communicate with the pre-written routines and tailor them to his needs. 

As part of most user programs, LIOCS provides an interface between user programs, 
LIOCS provides an interface between user's file processing routines and PIOCS. 
(All COBOL, FORTRAN, RPG II,PL 1 OPT and PL/I(D) programs use LIOCS; 
most assembler programs use LIOCS.) 






Using PIOCS 

Using PIOCS requires a detailed knowledge of device control and system operation. 
A channel program using the CCW assembler instruction must be written in con- 
junction with three macro instructions provided to communicate with PIOCS. 

CCB: This macro instruction generates a command control block. (Refer to 
Chapter 5 in this Section for a description of the CCB.) 

EXCP: This macro instruction is converted to an SVC to request execution of 
the channel program. It supplies the location of the corresponding CCB 
to the supervisor. 

WAIT: This macro instruction generates an SVC 7 which, tests CCB byte 2 bit 
(traffic bit) to determine when an I/O operation is complete. If the 
operation is not complete, the supervisor gets control until PIOCS within 
the supervisor sets the traffic bit to indicate completion of the operation. 
The WAIT macro should always be used for each I/O operation. 

A channel program written to make use of the RPS feature of a direct-access 

device must contain Set Sector commands and either Read Sector commands or the 

SECTVAL macro instruction. 

SECTVAL: This macro instruction generates an SVC 75 to supply the 
sector in which the record is located. 

For information on the format of Sector CCWs and on Rotation Position 

Sensing see the Appropriate reference manuel for the device. 

The example below shows part of an assembly program listing using the EXCP 
WAIT and CCB macros. A full description of these MACRO instructions can be 
found in DOS/VS Supervisor and I/O Macros. 






m 


H 


■■■ 




■1 




■ 








m 




• 


003B00 


47F0 


B75C 


03F5E 


261 


B SKIP 








^^H 










262 


••••******••*****•***•*****••*•*****•*•••******•••••••***••**•*•***•**• 






^^H 


^^1 












263 


*BUG GENERATOR ROUTINE* 






^^H 


^^H 


• 










264 


***•***••*•***«*•*««•****•***«****••**•*•**•**••••*•••«•••*•*•*••••*•*• 






^^H 


^^1 


003B0^ 


5010 


C6tE 


04E20 


265 


BUG ST I.RISAVE SAVE CONTENTS OF RETURN REGISTER 






^^B 


^^H 












266 


EXCP TCCBl 






^^H 


^^1 


•- 










270 


WAIT TCCBl 






^^H 


^^1 










276 


EXCP TCCB2 






^^H 


^^1 












280 


WAIT TCCB2 






^^H 


^^1 


• 


003B30 


9640 


C83F 


0S041 


286 


01 0PRESPltX'40* 






^^H 


■ 


003B34 


9503 


C83F 


05041 


287 

m 


CLI OPRESPltC'L* 


Cry 


g3 /«^ 


■ 


■ 


■1 


riHi 


wm 




HMIHBil^HHHIi^HHIIHHi 




m 


■ 



• 004E90 


4040404040404040 


■nrr 

1348 


TOWN 


DC 


CL4« • 

CLIO' • 








1349 


TCCBl 


CCB 


SVSLOGtTCCWItX>0400' 








1360 


TCCB2 


CCB 


SYSLOG.TCCW2,X'0400' 




• 004EBA 


000000000000 












004ECO 


09004F106000001C 


1371 


TCCWl 


CCW 


09,HSSG1,X'60',28 




^ 004EC8 


09004F2C60000020 


1372 




CCW 


09.MSSG2,X*60*,32 




• 004ED0 


09004F4C6000002F 


1373 




CCW 


09,HSSG3,X«60',47 




004E08 


09004F7B6000001F 


1374 




CCW 


09.HSSG4,X*60'.31 




^ 004EE0 


09004F9A60000021 


1375 




CCW 


09,NS$G5,X'60>,33 




• 004EE8 


09004FBB60000021 


1376 




CCW 


09.MSS66,X'60<.33 




004EF0 


09004FDC60000020 


1377 




CCW 


09,MSSG7,X«60',32 




^ 004EF8 


09004FFC60000020 


1378 




CCW 


09,MSSG8,X'60>,32 




• 004F00 


0900501C20000025 


1379 




CCW 


09,MSSG9,X>20',37 




004F08 


OA00504120000001 


1380 


TCCW2 


CCW 


10,OPRESPltX«20'tl 








1381 


*******************4i********************************************«*****« 


{^x y^ /^ 






1382 


^MESSAGE 


CONSTANTS* 



I 
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Using LIOCS 

Logical IOCS requires a minimum knowledge of the hardware I/O devices and is 
easily implemented within the problem program by the coding of macros. This 
system is also used by most of the high-level languages to control 1/0 operations. 

Two types of macro instructions are available to communicate with LIOCS. 

• Imperative Macros 

These macros order an action to be performed. For example, the macro GET 
commands LIOCS to place the next record in the user's problem program area. 

• Declarative Macros 

These macros supply information about the file and about types of processing the 
I/O routine will have to perform for the user. 
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Imperative Macros 

The problem programmer issues imperative logical IOCS macro instructions to 
initiate such functions as opening a file, making records available for processing, 
writing records that have been processed, and controlling physical device operations. 
A full list can be found ixvDOSiVS LIOCS Vol 1. 



f> 



Declarative macros DTP (Define the File) Macros 

For each imperative macro issued by the problem program, the assembler program 
generates an in-line expansion that links the instruction to the DTF table (and 
consequently, the logic module) for the specified file. As an operand, the imperative 
macro instruction must always contain the filename in the DTF macro describing 
the file. 

For VSAM files, the DTF macro is replaced by the ACB, EXLST and RPL macros 
to describe a file. 

Whenever logical IOCS imperative macro instructions are used in a problem program 
to control the transfer of records in a file, that file must be defined by a declarative 
DTF macro instruction. The DTF macro instruction describes (through various 
parameters specified by the problem programmer) the characteristics of the logical 
file, indicates the type of processing for the file, and specifies the virtual storage 
areas and routines, Figure 4.19 summarizes the various DTF table types supported 
by DOS/VS. Detailed descriptions of the logical IOCS file definition (DTF) macros 
and their parameters are described in Supervisor and I/O Macros. 

When one of these DTF macro instructions is encountered at assembly time, the 
assembler builds a DTF table tailored to the DTF parameters. The table contains: 

• Device CCB 

• A V-type address constant used by the Linkage Editor to resolve the linkage to the 
logic module with this DTF 

• Logic indicators; that is, one I/O area, two I/O areas, device type, etc. 

• Addresses of all of the areas (except work areas) and control functions used by 
this device. 
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Regardless of the method of assembhng logic modules and DTF tables (that is, 
together with the main program or separately), a symbolic linkage results between 
the DTF table and the logic module. The Linkage Editor resolves this linkage at 
edit time. 






Byte 


Bits 


Function 


0-15 




CCB. 


(0-F) 






16 




X'08' indicates DTF 


(10) 




relocated by OPENR. 


17-19 




Address of logic module. 


(11-13) 






20 




DTF type (X'10') 


(14) 






21 





1 = No rewind. 


(15) 


1 


1 = Unload rewind. 




2 


1 = Workfile. 




3 


1 = Read backward. 




4 


1 = Write. 




5 


1 =PCINTW. 




6 


1 = Force checking of read or write. 




7 


1 = Forward space before next operation. 


22-23 




Not used. 


(16-17) 






24-25 




Record length. 


(18-19) 






26-27 




Maximum BLKSIZE. 


(1A-1B) 






28 




Read op code. 


(1C) 






29-31 




EOF address. 


(1D-1F) 






32-39 




CCW. 


(20-27) 






40-43 




Block count, initialized 


(28-2B) 




00000000 for read 
forward, 

00400000 for read 
backward. 


44 





1 = Error routine. 


(2C) 


1 


1 = Ignore. 




2 


1 = Read next record switch. 




3 


1 = Record fixed unblocked. 




4 


Not used. 




5 


Not used. 




6 


Not used. 




7 


Not used. 


45-47 




Address of error routine. 


(2D-2F) 







J 



Note: Numbers in parentheses are displacements in hexadecimal 
notation. 

Figure 4.18. The format of the DTF table generated by a DTFMT declarative 
macro for a DTFMT workfile. 



An example of an assembly program listing is shown in Figure 4.22 that shows the 
expansion of a DTFMT macro. The macro expansion was obtained by the use of 
the assembly control statement PRINT GEN (a useful aid to use when in doubt). 
Figure 4.23 shows how this same DTFMT is printed in a system dump. The table of 
Figure 4.19 (opposite) lists all the DTF codes and relates them to their specific 
files. 



\^ 
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(Byte 20) 


DTF 


Description 




of DTP Table 








X'OO' 




DTFCD 


Combined files 




x'or 




DTFPT 


Paper tape files 




X'02' 




DTFCD 


Reader and 3881 Optical Mark Reader files 




X'03' 




DTFCN 


Console 




X'04' 




DTFCD 


Punch files 




X'08' 




DTFPR 


Printer files 




X'09' 




DTFOR 


Optical Reader files except 3881 files 




X'OA' 




DTFOR 


Optical Reader files (HEADER=YES) 




X'OB' 




DTFMR 


Magnetic Ink Character Recognition (MICR) and Optical Reader/Sorter files 




X'OC 




DTFDR 


3886 Optical Character Reader files 




X'10' 




DTFMT 
DTFCP 


Magnetic tape workfiies 

Magnetic tape workfiies (compiler). (Note 1 ) 




x'lr 




DTFMT 


Nonstandard or unlabeled tape files 




X'12' 




DTFMT 
DTFPH 


Standard labeled, output tape files 

Standard labeled, output tape files (physical IOCS) 




X'13' 




DTFMT 


Standard labeled, input tape files (read backward) 




X'14' 




DTFMT 


Standard labeled, input tape files (read forward) 




X'lA' 




DTFDU 


Diskette I/O Unit files 




X'20' 




DTFSD 
DTFCP 


Sequential DASD workfiies and data files 
DASD workfiies (compiler) 




X'21' 




DTFPH 


Sequential DASD files, MOUNTED=SINGLE (physical IOCS) 




X'22' 




DTFDA 


Direct access files 




X'23' 




DTFPH 


Direct access files, MOUNTED=ALL (physical IOCS) 




X'24' 




DTFIS 


Indexed sequential, LOAD file 




X'25' 




DTFIS 


Indexed sequential, ADD file 




X'26' 




DTFIS 


Indexed sequential, RETRVE file 




X'27' 




DTFIS 


Indexed sequential, ADDRTR file 




X'28' 




ACB 


Access Method Control Block for VSAM files 




X'30' 




DTFCP 


Compiler file for DOS Version 1 (Note 1 ) 




X'31' 




DTFCP 


Compiler file for DOS Versions 2 and 3 




X'32' 




DTFCP 


Compiler file for DOS Versions 2 and 3 (Note 2) 




X'33' 




DTFDI 


Device independent system unit files 




X'40' 




DTFBT 


Basic Telecommunications Access Method (BTAM) file (Notes 3 and 4) 




X'50' 




DTFQT 


Queued Telecommunications Access Method (QTAM) file (Notes 3 and 4) 




X'60' 










through 






Reserved 




X'67' 










Note 1: 


DTP type is X'30' except for tape or DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open 




phases change the DTP type to X'W for tape workfiies, or X'20' for DASD worl<files. 




Note 2: 


DTP type is X'32' except for DASD assigned to units SYSOOO to SYSnnn. In this case, the DTPCP open 
change the DTP type to X'20' for DASD worl< files. 


phases 


Note 3: 


The following control unit codes are ORed into the low-order 4 bits of the DTP type code. 
Control Unit Code 
7770 1 

2848 3 

2701 4 

2702 5 

2703 6 




Note 4: 


The DTP tables for BTAM and QTAM files are not documented in this manual. They are documented in 
publications DOS/VS BTAM Logic and DOS/VS QTAM Logic. 


the respective 


Note 5: 


VSAM differs from other DOS/VS access methods in that it does not use a DTP. The declarative macro equivalent for \ 




VSAM is the ACB. (Access Control Block). 





\J 



Figure 4.19. DTF type codes. 
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MOD (Module Generation) Macros 

To speed up assembly time and save storage, LIOCS uses another type of 
declarative macro instruction. Called logic module generation macros, declaratives 
of the form xxMOD describe the type of processing that the I/O routines will 
have to do for a particular file. A module is generated that handles only what the 
user has specified. 

The rhodule generation macros generate the data handling logic modules. These 
modules contain generalized routines needed to perform the functions of the 
logical IOCS imperative macros. The generalized routines in the logic modules are 
altered and made more specific through various parameters (specified by the 
problem programmer) included in the xxMOD macro statements. It is possible, 
therefore, to generate many variations of a particular type of logic module, each 
specifically suited to the need of the problem programmer. 

At assembly time, the assembler produces an EXTRN (External Symbol) card for 
every V-type constant (or EXTRN statement) in the user program. The assembler 
expansion of the DTP statement produces an EXTRN card with the name of the 
logic module needed to support the parameters that were specified in the DTP 
macro. The IBM-generated module names indicate the type of file and the support 
that each is capable of supplying for the DTP. Refer to Figure 4.20 for a breakdown 
of these names. Because of the descriptive nature of the IBM standard names, the 
programmer should be careful when specifying his own names for the logic modules 
to avoid overriding the IBM standard names. At the time this program is link- 
edited, the linkage editor resolves these EXTRN symbols (AUTOLINK). If the 
program is not to be executed immediately, option CATAL causes'the linkage 
editor catalogs the program into the core image library. 



1 


H 
J 
K 


xxxxxx 




L 






rlJB 


System Service and System Control 




IJC 


Card logic 




IJD 


Printer logic 




IJE 


Paper tape logic 


DATA < 


IJF 


Magnetic tape logic 


MANAGEMENT 


IJG 


Sequential DASD logic 




IJH 


Indexed Sequential DASD logic 




IJI 


Direct Access DASD logic 




-IJJ 


Device independent logic 




^IJL 


Teleprocessing routines 




IJM 


Optical Reader logic 


DATA / 
MANAGEMENT 


UN 
^iJU 


Diskette I/O Unit logic 
Magnetic Readers logic 




IJW 


Utilities 




IJZ 


OLTEP 




IKQ 


VSAM 



o 



Figure 4.20. A list of module names and their prefixes. 

Reentrant modules 



A re-entrant module is a logic module that can be used asynchronously, or shared 
by more than one file. The RDONLY (read only) parameter implies that the 
generated logic module is never modified in any way, regardless of the processing 
requirements of any file(s) using the module. To provide this feature, unique save 
areas external to the logic module are established, one for each task using the 
module. Each save area must be 72 bytes and doubleword aligned. Before a logic 
module is entered or an imperative macro is issued to the file, the task must provide 
the address of its unique save area in register 13. 



^,^ 
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Interrelationships of the DTP and Module Macro Instructions 

The DTFCD, DTFDA, DTFDI, DTFDU, DTFMR, DTFMT, DTFOR, DTFPR, 
DTFPT, and DTFSD declarative macros are similar in that each of them generates 
a DTF table that references an IOCS logic module. The first 1 6 bytes of each table 
have the same format, that is, a command control block (CCB) and bytes 17 to 19 
contain a logic module address. The length of each table depends on the particular 
device and file type. Figure 4.19 Usts the DTF device codes. To accomplish the 
linkage between the DTF table and the logic module, the assembler generates a 
V-type address constant in the DTF of a named CSECT in the logic module. To 
resolve this linkage, the Unkage symbols (module names) must be identical. The 
Figure below shows the relationship of the program, the DTF, and the logic 
module. The assumed parameters have generated a request for a MTMOD named 
IJFFBCWZ. Based on this name, the hnkage editor was able to locate the module. 
The GET statement generated coding to load the address of the DTF table into 
register 1 . This gives the program access to the MTMOD address, and the program 
branches to the required routine within the module. 
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o 



Problem Program 



GET TAPE 




DTF Table 



TAPE DTFMT 



Module 



IJFFBCWZ MTMOD 



DC V(IJFFBCWZ) 



Figure 4.21 The relationship between imperative and declarative macros. 

See also Figure 4.24 
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■■^■■■■■■■MH 






HH| 




■ 


||^^^HHMB^^^H| 














■ 


PAGE 15 


LOC 


OBJECT CODE AOORl 


AD0R2 


STMT SOURCE 


STATEMENT DOS/VS ASSEMBLER REL 29.0 


20.02 73-10-05 








664 TAPEOUT 


DTFMT 


BLKSIZE-800. 

OEVA00R-SYS0O3i 

FILABL'NO, 

lOAREAl-RITETAPE, 

RECFORH-FIXBLK, 

TYPEFLE-OUTPUT, 

MORKA-YES. 

RECSIZE«80 




C 
C 
C 
C 
C 
C 
C 
C 








665+» MAGNETIC TAPE IOCS - OTFMT - 5745-SC-TAP - REL. 28.0 




02250028 


003FAe 






666 + 


DC 


OOiOi 




3-8 29400025 


^ 003FA8 


000080000000 




667+TAPEOUT 


DC 


x;oooo8OOOOOO0; ccb 




30300025 


^ 003FAE 


01 




668 + 


DC 


ALKl) LOGICAL UNIT CLASS 




30400025 


003FAF 


03 




669+ 


DC 


ALIO) LOGICAL UNIT 




30500025 


^ 003F80 


00003FEO 




670+ 


DC 


AL4(IJF10060) CCM ADDRESS 




3-8 31000025 


^ COB F 84 


00000000 




671 + 


DC 


4X;00S CC8-ST BYTE.CSM CCW ADDRESS 


3-8 31100025 


003FB8 


00 




672 + 


DC 


ALKO) 




3-8 31800025 


H 003F89 


OOOOOO 




673 + 


DC 


VL3(IJFFZZHZ) ADDRESS OF LOGIC MODULE 




3-8 38500025 


• 003F8C 


11 




674+ 


DC 


X;ll; DTF TYPE 




39500025 


003FBD 


50 




675 + 


DC 


ALU 80) LOGICAL IOCS SMITCHES 




41300025 


A 003F8E 


E3C1D7C506E4E340 




676+ 


DC 


CL8;TAPE0UT; 




41800025 


^ 003FC6 


01 




677 + 


DC 


x:oi: 




42300025 


0O3FC7 


60 




678 + 


DC 


AL1(96) SWITCHES FOR OPEN 




3-8 45200025 


^ C03FC8 


00 




679+ 


DC 


ALllO) SWITCH ONE FOR OPEN AND 


CLOSE 47200025 ^H 


• 003FC9 


OOOOOO 




680+ 


DC 


AL3(0) USER LABEL ROUTINE 




47700025 ^M 


003FCC 


00 




681 + 


DC 


ALKO) SWITCH FOR OPEN AND CLOSE 




48600025 ^M 


H 003FCO 


003FCD 




682 + 


DC 


AL3(*) 




49000025 ^M 


C03F0O 


00000000 




683+ 


DC 


FjO; blockcount 




49100025 ^M 


O OOSFO* 


8680 F018 


00018 


684+ 


BXH 


11.12.24(15) DEBLOCKING FORWARD 




49700025 ^B 


Oa 003FD8 


41 EE 0001 


00001 


685 + 


LA 


14.1(14) INCREASE BLOCKCOUNT BY ONE 


49800025 ^M 


^ 003 FOC 


4700 0000 00000 




686 + 


NOP 


0(0) LOAD USER lOREG 




50600025 ^H 


C03FE0 


010047A120000320 




687+IJF 10060 




CCW X;01;.RITETAPE.Xi2O;.8OO 




55600025 ^H 


^ 0O3FE8 


000047A1 




688 + 


DC 


A(RITETAPE) ONE IQAREA 




3-10 56160026 ^H 


^ 003FEC 


000047A1 




689+IJF20060 




DC A(RITETAPE) DEBLOCKER 1 




3-10 52050026 ^H 


003FFO 


00000050 




690+ 


DC 


F;80i DEBLOCKER 2 




3-10 52100026 ^H 


OOBFF'r 


00004ACO 




691 + 


DC 


A(«lTETAPE+800-l) DEBLOCKER 3 




3-10 52150026 ^H 


^ M3FF8 


0320 




692 + 


DC 


Y(800) BLOCKSIZE 




52400025 ^H 


003FF& 


031F 




693 + 


DC 


V(800-l) BLOCKSIZE-1 




52600025 ^H 


C03FFC 


004F 




.694+ 
695 


DC 
MTMQD 


Y(80-l) RECSIZE-1 
WORKA=YES 




3-8 52900025 ^H 








696+» MAGNETIC TAPE IOCS - MTMOD - 5745-SC-TAP - REL. 29.0 


/DL29ZCN 00280029 ^H 


^ OOOOOO 






697+IJFFDTF 


DSECT 






03160025 ^H 


^ OOOOOO 


OOOOOOOOOOOOOOOO 




69B+IJFFNM 


DC 


4F;0i CCB 




03200025 ^H 






00003 


699 + IJFFCB2 


EQU 


IJFFNM+3 COMMUNICATION BYTE 2 




03240025 ^M 


^ 000010 


00000000 




700+ 


DC 


A(0) ADDRESS OF LOGIC MODULE 




03480025 ^H 


• 0OOO14 


10 




701 + 


DC 


X!l0; DTF TYPE 




03520025 ^H 


000015 


00 




702+IJFFSHl 


DC 


X;00; LOGICAL IOCS SWITCHES 




03560025 ,^H 


J^^^^OOOO^ 


C6D5Ci04C5404040 




703+ 


DC 


CL8:FNAHE : 


■ 


^^^0360002^^>85}^B 



o 



Figure 4.22. An example of an assembly listing showing the expansion of a 
DTFMT macro instruction. 

The program was assembled using the PRINT GEN assembler control statement 



PTFM 




10820 
7)40840 
040860 
040880 
040 SAO 
040800 
040BE0 



020CB97I 
58F100I0 
B960C68A 
OA020700 
OOIOOSEF 
4H0C086 



00008000 
00000000 
00041019 



B983C683 5810C0AE SSPlOOlO 45EF000C 5810CDAE 4100000B 

05EFD283 B936B93S D20CB93B CE49D203 B948C686 02068959 CE560203 

S810C0AE 58F10010 45EF0OOC 47F0BT5C 4110C0B6 45008746 00040878 

4110CO7E 4500B756 00040878 0A0247F0 B24C5810 CDAE4100 

5840COBA 47F0B24C 5810CDAE 41000088 58F10010 05EE*«TC^ B73A0700 

4500B792 00040878 0A020700 4110CD86 450Clin*a n»<<^«aiai^02OA0E 

OC60OIA3 000408S8 00040860 00041ED8 115o 1e3C1 D7C5D6E4 E3k o0160"[ 

00040845 00000000 86BCF018 41EE0001 47000000 01041019 200003201 

00041019 00000050 00041338 0320031F 004FOOOOI 00008000 0C000103 



000408BO 00040868 00041 ED8 11D8E3C1 D7C5C9D5 40400270 00000000 2C0407EC 

OOOOOOOF 866CF018 41EE0001 47000000 02040CF9 00000320 00040CF9 00040E39 

00000050 00041018 0320031F 004FOOOO 47FF001C 47FF001C OOOOCOOO 00000000 

000408F8 00040900 ()0042230 02000202 00040960 0004021A 02040960 20000050 






.O.QTA PEIN 



Figure 4.23. An example showing how the same DTFMT is printed in a dump. 



\J 
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Problem (user) program listing. 



I/O CONTROL 
SYSTEM 







ERROPT=YES, 
READ=FORWARD, 
RECFORM=FIXUNB, 
TYPEFLE=INPUT 



AREATWO I0AREA2 



Figure 4.24. A summary of the relationships between an imperative macro, a declarative macro, and a module 
generation macro specified in a program. 

The GET imperative macro is used in this illustration, which also shows the linkage between the generated DTF table and the 
logic module. 
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RPS (Rotational Position Sensing) Option 

System Support 

RPS support for devices attached to block multiplexer channels in full block 
multiplex mode (or their equivalent on Model 3 11 5/3 125 CPUs) is provided as an 
option in DOS/ VS. The option is specifiable at the operating system and device 
level. System support is provided at system generation time by coding the FOPT 
macro with RPS=YES. The IBM 3330/3333 supports RPS as a standard feature. 
The IBM 3340 supports RPS when 3340R is specified in the DVCGEN macro. 
Please note that Block Multiplexing cannot be used with the 231 1-1/3330, 
231 1-1/3340, and 2314/3340 Series Compatibility Features, if your CPU is a 
Model 3115 or a Model 3125. 

Data Management Support 

RPS support will be provided dynamically in Data Management when the 
operating system and the device support and all of the following conditions are met: 

• One of the DASD access methods is being used, that is, the file is defined by one 
of the following DTFs: DTFSD, DTFDA, DTFIS, DTFDI, or DTFPH . 

• There is room in the user's virtual storage to extend the DTF. 

• An RPS version of the logic module necessary to process the DTF has been, or 
can be, loaded into the SVA. 



.iir~^. 



''*^ > 



%' 



At OPEN time, if it is determined that the system and the device both support 
RPS, a bit is set in the DTF tables (see Figure 4.24A). This bit will not be turned 
off until CLOSE time whether or not the other conditions for RPS support are 
met. Space is then obtained for the DTF extension. The amount is dependent on 
which access method is in use (see Figure 4.24 A). If space is unavailable, the 
DTF will be opened without RPS support. 

Determination as to which RPS logic module is required to process this DTF is 
made and the module is loaded into the SVA, unless it is already there in which 
case it is sharable across partitions. If the required logic module cannot be made 
available, OPEN releases the DTF extension space and the DTF is opened 
without RPS support. 

If the space for the DTF extenstion is available and the RPS logic module is loaded 
into the SVA, OPEN sets another bit in the DTF table indicating that the data set 
will be processed in RPS mode (see Figure 4.24A). 

The first section of the DTF extension contains the RPS channel program (so that 
the pointer to the extension is also the pointer to the RPS CCW chain). The 
extension also contains CCW build and work areas necessary to construct the RPS 
channel program, a sector value bucket, and register and address save areas (see 
Figure 4.24B for DTF extension format). 

The addresses of the original channel program and logic module are saved in the 
extension while the address of the RPS channel program is put into bytes 9 - 11 of 
the DTF and the address of the RPS logic module is put into bytes 17 - 19* These 
pointers are restored at CLOSE time. 

The original DTF is used for all fields except the channel program so that no 
mapping between the DTF and the extension is required, (see Figure 4.24C for an 
overview of the OPEN.) 
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No program recompiling or relink -editing is required, though there must be enough 
dynamically allocatable space in the user's partition for the RPS extensions. Since 
RPS gets this space via the GETVIS macro, the SIZE:= parameter must be 
specified in the program's EXEC statement. 

The DTF extension provides a register save area for the RPS logic modules since 
they are all reentrant and sharable between partitions. If the original non-RPS 
logic module is reentrant because it was coded read-only, the user-supplied save 
area will not be used. The RPS logic modules are supersets of functions needed 
to process the DTF. 

System Component Support 

System Components support RPS where there is a significant amount of DASD I/O. 
This support is provided by building RPS channel commands and then changing 
these to NO-OPs or TICs if the affected device or system does not support RPS. 

Wherever the component uses LIOCS for its I/O, this optional support is provided 
through the data management support of RPS. 

Where LIOCS is not used, the component logic interrogates the indicator set by 
OPEN for I/O using DTFPH or, when DTFPH is not used, the same PUB and 
COMREG indicators interrogated by OPEN. 

The system components supporting RPS are: 

• POWER 

• Supervisor Fetch and Paging I/O 

• Linkage Editor 

• Job Control 

• Librarian 

• Checkpoint/Restart 

• System Utilities 
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DTFDA 
DTFPH* 


DTFSD 
DTFPH* 


DTFSD 

(work 

files) 


DTFDI 


DTFIS 
(All) 


DTF offset: set at byte 


32(20) 


44(2C) 


37(25) 


42(2A) 


65(41) 


System supports 
RPS bit 


1 


1 


1 


7 


4.7# 


DTF has been 
extended bit 


7 


7 


7 


1 


5 


Length of DTF 
extension 


512 


256 


256 


256 


384 



* DTFPH has no logic module; therefore, the only RPS processing done is the setting of the 
System Support RPS bit. 

# Bit 4 on - prime data resides on an RPS device 
Bit 7 on - index resides on an RPS device 

Figure 4.24A. DTFs for RPS Support 
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172(AC) Sector Values (up to 4) 






176(B0) Address of Original Channel Program 


180(B4) Address of Original Logic Module 
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72-Byte Register Save Area 
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not present for SAIVI or Device Independence 
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Figure 4.24B DTF Extension Work Area for RPS 
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(see Figure 4.24B) 
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Figure 4.24C Effect of RPS Support on OPEN 
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VSAM (Virtual Storage Access Method) I/O 

VSAM IOCS differs from that of other DOS/VS access methods as follows: 

• VSAM declarative macros are ACB, EXLST, and RPL instead of DTP and 
xxMOD. 

• VSAM routines are dynamically loaded into virtual storage when a VSAM 
file is opened. They are not assembled or link edited with the user's 
program. 

Declarative Macros 

The VSAM declarative macros are ACB, which creates an Access-Method Control 
Block; EXLST, which creates an Exit List; and RPL, which creates a Request 
Parameter List. The Access-Method Control Block (ACB) is like a DTP in that it 
defines the file to be processed. Opening a VSAM file involves opening the ACB 
for that file. The Request Parameter List (RPL) defines the parameters necessary 
for a particular execution of a request (imperative) macro. It contains some of the 
information, such as address of the user's work area, located in the DTP in other 
access methods. The Exit List (EXLST) contains the addresses of optional user 
exit routines. Up to four exit routines can be specified-one for handling end-of- 
file, one for handling logical errors, one for handling I/O errors, and one to allow 
user processing during VSAM I/O operations. 

Codes indicating errors resulting from execution of imperative macros are set in 
registers or in the ACB or RPL as described below. 

Imperative Macros 

The user's program issues imperative macros to open or close a file and to retrieve, 
add, delete, or update records. It can also issue imperative macros to generate, 
modify, display, or test the control blocks created by the declarative macros. When 
control is returned to the user's program after execution of an imperative macro, a 
"return code" is set in the low-order byte of register 15, The return code indicates 
the results of the macro execution. If an error or certain other exceptional 
conditions occur, an "error code" will be set in the ACB, the RPL, or in register 0, 
depending on the macro. Pigure xx summarizes the return codes and error codes 
issued by the imperative macros and user exit routines which can be used. More 
information on the return codes and user exits as well as a complete hst of the error 
codes and their meanings is in the VSAM chapter of DOS/VS Supervisor and I/O 
Macros. 

An ACB, EXLST, or RPL can be created dynamically, during program execution, 
by using the GENCB macro. The fields in these control blocks can be modified 
during program execution by using the MODCB macro. Refer to DOS/VS 
Supervisor and I/O Macros for information on how to write the GENCB and 
MODCB macros. 

RPL Debugging Hints 

If the RPL hold byte, 35(23), is set to X'PP', the error occurred while the request 
was being executed by VSAM. Check the type of request byte, 29(1D), to 
determine what request was active. If the request was a POINT, GET, or PUT, 
check the following parameters in the RPL (of GENCB for RPL) in your program 
to ensure that they are valid: 

Macr o Check these RPL Parameters 

POINT ARG and KEYLEN 

GET AREA and AREALEN 

IP OPTCD=DIR or OPTCD=SKP, also check ARG and KEYLEN 

PUT AREA and RECLEN 

If the RPL parameters are specified correctly or if the type of request is other than 
POINT, GET, or PUT, the error is probably in VSAM itself. Save the dump, console 
log, and program listing and contact your IBM programming support representative. 

Note: MODCB, SHOWCB, and TESTCB macros also set the RPL Hold byte. If this 
byte was set by one of those macros, the type of request byte will have no meaning. 
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Imperative 
Macro 


Return Code 
found in 


If Return 
Code no 0, 
Error Code 
found in 


Method of 
Inspecting 
Error Code 


Exits Taken if User Exit 
Routines are Supplied 


OPEN 

CLOSE 

TCLOSE 


Register 
15 


ACB 


Code ERROR 
parameter 
in TESTCB** 
or SHOWCB 


SYNAD EXIT FOR 
I/O errors in 
CLOSE; code 
FDBK in TESTCB** 
or SHOWCB 


GET 

PUT 

POINT 

ERASE 

ENDREQ 


Register 
15 


RPL 


Code FDBK 
parameter 
in TESTCB** 
or SHOWCB 


LERAD exit for 
logical errors* 
(Return Code 
is X'08') 
SYNAD exit for 
I/O errors 
(Return Code 
is X'OC) 


GENCB 
SHOWCB 
TESTCB 
MODCB 


Register 
15 


Register 



Inspect 

Register 




None 






End-of-file is indicated by an error code of X'04'. The EODAD exit is taken if an EODAD routine is supplied. 
Otherwise, the LERAD exit is taken. 

A user routine can be supplied to receive control if NSAM is unable to test for the condition specified because of 
an error occurring during execution of the TESTCB macro. The routine is pointed to by the ERET parameter 
of TESTCB. 



Figure 4.25. Summary of Error Checking for VSAM Imperative Macros 



Error Detect/on with VSAM Macros 

When an error occurs, the user can either attempt to correct it in his program, close 
the file, or terminate the job. These actions can be taken in the SYNAD and LERAD 
exit routines or in-line in the program. If the user wants to evaluate the error 
condition after the job has finished, he should write the error code in a field in 
his program (for locating it in a dump output) or in a message. He obtains the error 
code from the ACB or the RPL by issuing either a TESTCB or a SHOWCB macro. 

The SHOWCB macro is used to display the contents of an ACB, EXLST, or RPL 
in a work area specified by the user. The contents include the fields coded for each 
block by the user. An ACB also includes fields, such as number of levels in the 
index, read from the file's catalog entry when the file is opened. The TESTCB 
macro is used to test the value of a field or a combination of fields in the ACB, 
EXLST, or RPL. See the Supervisor and IjO Macros publication for information 
on how to write the SHOWCB and TESTCB macros. 

The SHOWCB and TESTCB macros can also be used when a task terminates 
abnormally (such as through a program check). The VSAM macro can be included 
in a routine called by the STXIT macro instruction. 
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ySAM Control Blocks 

When a VSAM file is opened, VSAM uses the information suppUed by the user in 
the ACB, EXLST, and RPL along with information in the file's catalog entry to 
construct VSAM control blocks. The contents of the EXLST, RPL and ACB control 
blocks are shown in Figures 4.25 .B, C and D. Additional control blocks internal to 
VSAM are pointed to by the ACB and RPL and are described in DOS/VS LIOCS 
Logic, Volume 4: VSAM. 



REGISTER "1 



to RPL 






AMBL 


ACB 


Points to 
internal 
VSAM 
control blocks 


AMBL 
EXLST 


» 




EXLST 






* 







Figure 4.25.A. Relationship of VSAM Control Blocks 



Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier - X'81 ' 


1(1) 


1 


EXLST active byte. Set to X'FF' when file is open. 


2(2) 


2 


Length of EXLST. The length will be 10 bytes, 15 bytes, 
or 20 bytes. 


A IA\ 
-r\-r; 


1 


Reserved 


5(5) 


1 


EODAD entry flags: 

X'80' - Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


6(6) 


4 


Address of the user's EODAD exit routine. 

Set from the EODAD parameter of the EXLST macro. 


10(A) 


1 


SYNAD entry flags: 

X'80' - Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


11(B) 


4 


Address of the user's SYNAD exit routine. Set from the 
SYNAD parameter of the EXLST macro. 


15(F) 


1 


LERAD entry flags: 

X'80' — Entry present 

X'40' — Entry active 

X'20' — Entry to be dynamically loaded 


16(10) 


4 


Address of the user's LERAD exit routine. Set from LERAD 
parameter of the EXLST macro. 


20 (14) 


1 


EXCPAD entry flags: 

X'80' - Entry present 

E'40' — Entry active 

X'20' — Entry to be dynamically loaded 


21 (15) 


4 


Address of the user's EXCPAD exit routine. 

Set from EXCPAD parameter of the EXLST macro. 



I I 
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Figure 4.25.B. Explanation of the contents of the EXIT LIST (EXLST) 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier - X'OO' 


1(1) 


1 


X'OO' 


2(2) 


2 


Length of RPL 


4(4) 


4 


Relative Byte Address (RBA) of last record process or DD field indicator. 


8(8) 


4 


Address of thq key or RBA which is the search argument. Set from ARG parameter or RPL or GENCB 
macro. 


12(C) 


4 


Address of user's work area which contains the logical record. Set from AREA parameter of RPL or 
GENCB macro. 


16(10) 


4 


Length of the last logical record processed. Set from the RECLEN parameter of RPL or GENCB macro 
and modified (for variable length records) by the user for a PUT macro and by VSAM for a GET macro. 


20(14) 


4 


Length of the user work area. Set from the AREALEN parameter of RPL or GENCB macro. 


24(18) 


4 


Address of the ACB 


28(1 C) 


1 


X'Or 


29(1 D) 


1 


Type of current request: 
X'OO'- POINT macro 
X'04'- GET macro 
X'08'- ERASE macro 
X'OC- PUT macro (update) 
X'10'- PUT macro (insert) 
X'18'- Internal VSAM request 






X'iC- ENDREQ macro 

X'20' to X'24'- internal VSAM requests 


30(1 E) 


2 


Key length 


32(20) 


1 


First byte of option codes (set from OPTCD parameter of RPL of GENCB macro): 

X'80'— Keyed access 

X'40'— Addressed access 

X'20'— Sequential processing 

X'10'— Direct processing 

X'04'— Skip sequential processing 

X'02'— Control interval access 

X'Or- Update 


33(21) 


1 


Second byte of option codes: 

X'80'— Search key greater than or equal 

X'40'— Generic key request 

X'20'— Note string position 

X'10'- No update 

X'08'— Locate mode 

X'04'— User buffer processing 


34(22) 


1 


RPL available byte. If set to X'FF" the RPL is not available for a request. If set to X'OO', the RPL is 
available for a request. 


35(23) 


1 


RPL hold byte. If set to X'FF', the RPL is active (a request has been started but has not been completed). 
If set to X'OO', the RPL is not active (no requests are in process). 


36(24) 


1 


X'FF' 


37(25) 


1 


Return code (also set in Register 15). See Supervisor and I/O Macros for a description of return codes. 


38(26) 


1 


Reserved 


39(27) 


1 


Error code (describes the type of error detected by VSAM). See Supervisor and I/O Macros for a 
description of the error codes. 


40(28) 


4 


Address of the Placeholder (PLH). This is an internal VSAM control block and is described in 
DOS/VS LIOCS Logic Volume 4: VSAM. 


44(2C) 


8 


Reserved 



Figure 4.25.C. Explanation of the contents of the REQUEST PARAMETER LIST (RPL) 
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Displacement 
dec (hex) 


Length 
in bytes 


Description and/or Contents 


0(0) 


1 


Control block identifier - X'AO' 


1(1) 


1 


ACB active byte. Set to X'FF' when ACB is open. 


2(2) 


2 


Length of ACB 


4(4) 


4 


Address of the Access Method Block List (AMBL). This is an 
internal VSAIVl control block and points to other internal 
VSAM control blocks. They are described in DOSA/S 
LIOCS Logic Volume 4: VSAM. 


8(8) 


4 


Address of the VSAM load module (VSAM routines). 


12(C) 


2 


Reserved 


14(E) 


2 


Number of data buffers 


16(10) 


2 


Number of index buffers 


18(12) 


1 


MACRF first byte: 
X'80' — Keyed access 
X'40' -- Addressed access 
X'20' — Control interval access 
X'10' — Sequential processing 
X'08' — Direct processing 
X'04' - GET macro 
X'02' - PUT macro 
X'Or- User buffers 


19(13) 


1 


MACRF second byte: 

X'20' — Skip sequential processing 


20(14) 


1 


DOS/VS DTF identifier - X'28' 


21(15) 


1 


Open/Close flags 

X'10' -ACB is open 

X'01 ' - ACB will accept keyed as well as RBA requests 

Other Open/Close flags are internal to VSAM 


22(16) 


1 


x'or 


23(17) 


1 


Error code. This code describes errors that occur during Open 
Close, or TCLOSE. The codes are described in Supervisor and 
I/O Macros. 


24(18) 


4 


Size of VSAM's buffer pool 


28(1 C) 


8 


Filename of ACB. Set from label field of ACB macro or 
DDNAME parameter of ACB or GENCB macro. 


36(24) 


4 


Address of password. Set from PASSWD parameter of ACB 
or GENCB macro. 


40(28) 


4 


Reserved 


44(2C) 


4 


Address of VSAM's buffer pool 


48(30) 


4 


Address of Exit List (EXLST) 


52(34) 


4 


Reserved 



it. 



Figure 4.25.D. Explanation of the contents of the Access-Method Control 
Block (ACB) 

Note: ACB . The ACB macro produces an Access Method Control Block (ACB) 
for a VSAM file. The control block identifies the key -sequenced file and its index 
or the entry-sequenced file that is to be processed, and indicates the types of 
requests that are to be made. The ACB is similar to a DTF in that it identifies the 
file to be processed. However, most information about the file, such as key length 
and record format, is specified in the Access Method Services' (AMS) DEFINE 
command. Information supplied in this command resides in the VSAM catalog 
and is read into storage when the ACB is opened. 
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Command Control Block (CCB) 

This information block is generated in the problem program during assembly or 
during program operation, depending on the methods of I/O control employed by 
the program. As described in Chapter 4 the CCB is generated as the first 1 6 bytes of 
a DTF when the program is using LIOCS. When using PIOCS, the CCB macro 
generates the CCB. 

The CCB establishes communication between the problem program and physical 
IOCS. The CCB is 16 bytes in length with eight major fields, and does not have to be 
aligned on a doubleword boundary. Eight optional bytes are generated if the user 
requests that a sense operation be performed on the occurrence of an I/O error. 
Data transferred from the device to real storage during a sense operation provides 
information concerning unusual conditions detected in the last operation and the 
status of the device. All data in the CCB is in the hexadecimal format. 

By examining the contents of the CCB in a dump, the following information can 
be obtained about the associated I/O operation: 

• Whether the operation was completed (by inspecting the traffic bit and 
device-end bit) 

Status of the channel and device to which the I/O command was issued 
The logical unit involved in the operation 
Whether the CCB is in a real or a virtual partition 
The address of the channel program (the first CCW in a CCW string) 
The address of the next CCW to be executed, in the channel program 
(Subtracting eight from this address gives the address of the last CCW used.) 

• The residual count associated with the last CCW. 

Note: When all the following coditions have been met, bytes 9-1 1 will now be 
pointing to a non-RPS channel program in the DTF, but the one actually used 
has been released from the user's virtual save area: 

• RPS was in effect . 

• The data set has been closed . 

• The CCB was generated as the first 1 6 bytes of a DTF 
in a program using LIOCS. 

This count taken from the channel status word (CSW), is stored by PIOCS when 
the pointer to this CCB is removed from the channel queue. The residual count, in 
conjunction with the original count specified in the last CCW used, indicates the 
number of bytes transferred to or from the area designated by the CCW. When an 
input operation is terminated, the difference between the original count in the 
CCW and the residual count in the CSW is equal to the number of bytes transferred 
to storage. For an output operation, the difference is equal to the number of 
bytes transferred to the I/O device. 
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How to locate 

1. For programs using LIOCS, locate the address of the associated DTF in the 
program listing. Then use the linkage editor map to locate the DTF in the dump. 
The first 16 bytes of the DTF is the CCB. 



2. For programs using PIOCS, locate the address of the CCB macro in the program 
Usting and use the linkage editor map to locate the CCB in the dump. 

3. If the interrupt code in the PSW stored in the partition save area is 00 or 07 
(SVC or SVC 7), the contents of general register 1 may contain the address of 
the CCB. To confirm whether the address in register 1 is that of a CCB, inspect 
the first few bytes starting from that address. (It is not difficult to recognize 

a valid CCB in a dump. See the example below.) 
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Figure 4.26 The pointer and CCB in a dump 

Figure 4.27 parts 1, 2 and 3 illustrate the format and contents of the information 
contained in any CCB. 
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Byte(s) 


Description 


0-1 Used for residual Count. 






2-3 Transmitting infornnation 
between Physical IOCS 


Byte 2 


Set on by: 








& Problem Program 


BitO: 


Traffic Bit (Wait)/(Note 5) 


PIOCS* 




Bit 1: 


End of File(/* or /&); 3211-UCSB Parity Check (Line 
Complete). (Note 2) 


PIOCS 




Bit 2: 


Irrecoverable I/O error 


PIOCS 




Bit 3: 


Accept Irrecoverable I/O error 


Pr. Pr.** 




Bit 4: 


5425 not ready, or return DASD Data Checks, 2671 
errors, 3540 Diskette Data Checks, or 101 7/1018 errors 
to the user; indicate action-type message for Video 
Display Unit 






Bit 5: 


Post at Device End (Note 5) 


Pr. Pr. 




Bit 6: 


Return Tape Read Data Check; 1018 or 2560 Data 
Check 2520, 2540, 2560, 3881 or 5425 Equipment 
Check Accept 3504, 3505 or 3525 Perm. Error, DA 
SD-Data Checks on Read or Verify Command on 321 1 
or 2245 Passback Requested. 
(Notes 3, 6 and 8) 






Bit 7: 


User Error Routine 


Pr. Pr. 


Byte 3 


Set on by: 


BitO: 


DASD-Data Check in Count Area; Permanent Error for 


PIOCS 






3330, 3340; MICR-SCU Not Operational; 1287/1288- 








Data Check; 321 1 -Print Check/Equipment Check; 








3540 Special Record Transferred. 






Bit 1: 


DASD-Track Overrun; MICR-lntervention required; 
1287-Keyboard Correction in Journal Tape Mode; 1017- 
Broken Tape; 3211 -Print Quality/Equipment Check. 


PIOCS 




Bit 2: 


DASD-End of Cylinder; MICR-(Note 4); 1287/1288- 
Hopper Empty in Document Mode. 3211/2245-Line 
Position Error. (Note 7) 






Bit 3: 


2520, 3881 -Equipment Check; 2560, 3203, 5203, 
5425 Data Check/Equipment Check; Tape-Read 
Data Check; DASD-Any Data Check 1287-Equipment 
Check; 1017/1018-Data Check; 321 1 -Print Check/Data 
Check; 3504, 3505, 3525 Perm. Error, (Note 8); 
3540 Diskette Data Check. 


PIOCS 




Bit 4: 


Non-Recovery Questionable Condition: Card-Unusual 
Command Sequence; DASD- No Record Found; 1287/ 
1288- Document Jam or Torn Tape; 3211-UCSB Parity 
Check (Command retry); 5425 not ready 


PIOCS 




Bit 5: 


No Record Found Condition (Retry on 2311, 2314, 
2319, 3330 or 3340) 


Pr. Pr. 




Bit 6: 


Carriage Channel 9 Overflow or Verify Error for DASD; 
1287-Document Mode-Late Stacker Select; 1288-End of 
Page. 


PIOCS 




Bit 7: 


Command Chaining, Retry from the next CCW to be 
executed 


Pr. Pr 



*Physical IOCS **Problem Program 

Figure 4.27 Explanation of the contents of the CCB, part 1 of 3 
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Count 


Transmis- 
sion infor- 
mation 


CSW 

Status 

Bits 


Type 
Code 


Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 5 


6 7 


8 


9 11 


12 


13 15 


16 23 



p' 



Byte(s) 



4-5 CSW Status Bits 



6-7 Type Code 



Description 



Byte 4 (Note 1) 



Bit 0(32) Attention 

1 (33) Status Modifier 
2(34) Control Unit End 
3(35) Busy 
4(36) Channel End 
5(37) Device End 
6(38) Unit Check 
7(39) Unit Exception 



Byte 5 



Bit 0(40) Program Controlled 
Interruption 
1 (41) Incorrect Length 
2(42) Program Check 
3(43) Protection Check 
4(44) Channel Data Check 
5(45) Channel Control Check 
6(46) Interf. Control Check 
7(47) Chaining Check 



Byte 6 



X'Ou' Original CCB (Bytes 9-11 and 13-15 contain virtual addresses 
X'2u' Translated CCB (Byte 9-1 1 contain real address, bytes 1 3-1 1 

virtual address) 
X'4u' BTAM request original CCB (Bytes 9-1 1 and 1 3-1 5 contain 

virtual addresses) 
X'6u' BTAM request translated CCB (Bytes 9-1 1 contain real address, 

bytes 13-1 5 virtual address) 
X'8u' User-translated CCB in virtual partition (Bytes 9-1 1 and 1 3-1 5 

contain real addresses) 

Note: Any one of the above incremented by X'10' (bit 3 on) indicates 
automatic switching to the beginning of the next cylinder at 
End of Cylinder condition, 
u: 0= The address in byte 7 refers to a System Logical Unit. 

1= The address in byte 7 refers to a Programmer Logical Unit. 



Byte 7 



Hexadecimal representation of SYSnnn: 



SYSRDR 


= 00 


SYSIPT 


= 01 


SYSPCH 


= 02 


SYSLST 


= 03 


SYSLOG 


= 04 


SYSLNK 


= 05 


SYSRES 


= 06 


SYSSLB 


= 07 


SYSRLB 


= 08 


SYSUSE 


= 09 



SYSREC 


= OA 


SYSCLB 


= OB 


SYSVIS 


= OC 


SYSCAT 


= OD 


SYSOOO 


= 00 


SYS001 


= 01 


SYS002 


= 02 


SYSnnn 




(Note 9) 





i 



y 



Figure 4.27. Explanation of the contents of the CCB, part 2 of 3 
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Count 


Transmis- 
sion infor- 
nnation 


CSW 

Status 

Bits 




Type 
Code 




Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 


5 6 


7 


8 


9 11 


12 


13 15 


16 23 






Byte(s) 



Reserved for 
Logical IOCS 



9-1 1 CCW Address 



12 Reserved for 
Physical IOCS 



1 3-1 5 CCW Address 
* in CSW 



16-23 Optional 

Sense CCW 



Description 



Buffer Offset 
ASCII Input Tapes 

ASCII Output Tapes Fixed 

Variable 

Undefined 



X'00'--X'63' 

X'OO' 

X'OO' or X'04' 

X'OO' 



Virtual or real address of CCW associated with this CCB depending 
on byte 6: 

Real address if byte 6= X'2u', X'6u', or X'8u'; 
Virtual address if byte 6= X'Ou', or X'4u'. 



X'80' CCB being used by ERP 

X'40' Channel Appendage Routine present for TP device, VSAM 

or POWER 

X'20' Sense Information desired 

X'10' Message writer 

X'08' EU Tape Error 

X'04' OLTEP Appendage available 

X'02' Tape ERP Read Opposite Recovery 

X'01' Seek Separation 



Virtual Address of CCW pointed to by CSW at Channel End 
(if byte 6= X'8u', it is the real address) or address of the 
Channel End Appendage Routine for TP devices, 
VSAM or POWER. 



8 bytes appended to the CCB when Sense Information is 
desired. 



Note 1 : Bytes 4 and 5 contain the status bytes of the Channel Status Word (Bits 32-47). 
If byte 2, bit 5 is on and device end results as a separate interrupt, device end 
will be OR-ed into CCB byte 4. 

Note 2: Indicates /* or/& statement on SYSRDR or SYSIPT. 
Byte 4, bit 7 (unit exception) is also on. 

Note 3: DASD data checks on count not returned. 

Note 4: For 1255/1259/1270/1275/1419, disengage. For 1275/1 41 9D, I/O Error is 
external interrupt routine (Channel data check or bus-out check). 

Note 5: The traffic bit (Byte 2, bit 0) is normally set on at channel end to signify that the 
I/O was completed. If byte 2, bit 5 has been set on, the traffic bit and bits 2 and 6 
in byte 3 will be set on at device end. Also see Note 1 . 

Note 6: 1018 ERP does not support the Error Correction Function. 

Note 7: This error occurs as an equipment check, data check or FCB parity check. 
For 2245, this error occurs as a data check or FCB parity check. 

Note 8: For 3504, 3505, 3525 input or output files using ERROPT, byte 3-bit 3 is set on if a 
permanent error occurs. Byte 2-bit 6 is set on to allow you to accept permanent errors. 

Note 9: SYSnnn= 255-(Number of partitions x 14). 



t) 



Figure 4.27. Explanation of the contents of the CCB, part 3 of 3. 
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The channel program 

A channel program consists of one or more CCWs (channel command words). The 
channel program is generated during assembly or during program operation, 
depending on the method of I/O control employed by the program. A CCW specifies 
the command, the storage area to be used for the I/O operation, and the action to 
be followed when the operation is completed. When a program is running in a 
virtual partition, the CCWs are copied into the real address area. 

Translation from the virtual I/O area addresses in the CCW to real addresses is 
accomplished either by the supervisor channel program translation routines. 

The contents of CCWs should be inspected when the cause of a system malfunction 
leads you to suspect I/O operation errors. For example, parts of a program being 
overwritten and causing invalid instructions, or unexpected information in your 
program I/O data area will probably cause a program check and generate incorrect 
output from your program. 

By examining the contents of the channel program the following information can 
be obtained: 

• Validity of the operation code and of the sequence of CCWs used. If either of 
these is invalid, an informatory message is normally printed on SYSLOG to 
help you to determine the cause of the error. 

(Consult the component manual for the I/O device for the valid codes and 
sequence of use.) 

• Data address in the last CCW used. Translated channel programs are 
destroyed in a system dump by the channel programs required for the DUMP 
and by channel programs started for other partitions. However, they can be 
located in a stand-alone dump, an example of which is shown in Appendix G. 
(Refer to chapter 12 in this section for methods of translating real addresses 
to virtual and vice-versa.) 

• Count in the CCW. This must be a byte count of one or more for any I/O 
operation not involving magnetic tape units. (For a transfer in channel (TIC) 
command, the count may be zero.) 

• When working with wrong length records or variable length records, the 
suppress length indicator should be set to 1 to prevent an error condition. 






J 
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How to locate: 



Bits 8-31 of the CSW (Channel Status Word) stored in location X'40' of low 

address storage contain the address of the next CCW to be executed. Subtract 

eight from this address to obtain the address of the last CCW used. (Refer to 

Section 2-E-2 for details of low address storage.) 

Caution: The data stored in low address storage may be overwritten by the 

dump program. If this is thought to be the case, use the method described 

below. 

Bytes 9-11 of the CCB associated with the channel program contain the 

addresses of the first CCW in the channel program. Bytes 13-15 of the same 

CCB contain the address of the next CCW. Subtract eiglit from this address 

to obtain the address of the last CCW used. 

The figure below shows the format and contents of any CCW. 
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Command 


Data Address 


Flags 


00 


TP code 


Count 



32 



38 



40 



48 



63 






FIELD 


DESCRIPTION 


Command 
Code 


Bits 0-7: 

Specify tiie operation to be performed. 
Consult device component manual 


Data Address 


Bits 8-31: 

Specify the location of a byte in main storage. It is the first location 
referred to in the area designated by the CCW. 


Flags 


Bits 32-36: 

Specify the flag bits used in conjunction with the CCW. 

Bit 32- 

Chain-Data (CD) causes the address portion of the next CCW to be 
used with the current CCW. 

Bit 33- 

Chain-Command (CO causes the command code and data address 
of the next CCW to be used. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 34- 

Suppress Length Indication (SLI) causes a possible incorrect length 
indication to be suppressed. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 35- 

Skip (SKIP) suppresses the transfer of information to real storage. 

Bit 36- 

Program Control Interruption (PCI) causes the channel to generate 

an interrupt when the CCW is fetched. 
Bit 37- 

IDAL bit. Set to 1 if I/O area crosses page boundary, that is, if the 

I/O area is not confined to one page frame in real storage. 


Reserved 


Bits 38-39: 

(Must contain zeros)* 


TP 


Bits 40-47: 


Count 


Bits 48-63: 

Specify the number of bytes in the operation 






*The transfer in channel command (TIC) is the one exception to this statement. 
Figure 4.28. Explanation of contents of the CCW 
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SUPERVISOR CALLS A problem program running in any partition fields control to the supervisor by 

issuing a supervisor call instruction. The SVC instruction contains a code that 
indicates its purpose. For example, SVC requests the supervisor to execute the 
channel program. Some SVCs are optional and cause program cancellation if the 
supervisor does not support the option requested. 

A complete list of DOS/VS SVC codes with the associated macro instructions that 
generate the SVC is shov^n in Figure 4.29 parts 1, 2 and 3. 

A detailed description of the SVCs can be found in DOS/VS Supervisor Logic. 
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SVC 
Dec Hex 


Macro supported 


Function 








EXCP 


Execute Channel Program 


1 


1 


FETCH 


Fetch any phase 


2 


2 




Fetch a logical transient (B-transient) 


3 


3 




Force dequeue 


4 


4 


LOAD 


Load any phase 


5 


5 


MVCOM 


Modify supervisor communication region (if issued by 
MVCOM macro) Fetch any other physical transient (if 
issued by a physical transient) 


6 


6 


CANCEL 


Cancel a problem program or task 


7 


7 


WAIT 


Wait for a CCB or TECB 


8 


8 




Transfer control to the problem program from a logical 
transient (B-transient) 


9 


9 


LBRET 


Return to a logical transient (B-transient) from the 
problem program after an SVC 8 


10* 


A 


SETIME 


Set timer interval 


11 


B 




Return from a logical transient (B-transient) 


12 


C 




Reset switches in partition communication region. 


13 


D 




Set switches in partition communication region. 


14 


E 


EOJ 


Cancel job and go to job control for end of job step 


15 


F 


SYSIO 


Headqueue and execute channel program 


16* 


10 


STXIT(PC) 


Provide supervisor with linkage to user's PC routine 
for program check interrupts 


17* 


11 


EXIT(PC) 


Return from user's PC routine 


18* 


12 


STXIT(IT) 


Provide supervisor with linkage to user's IT routine 
for interval timer interrupts 


19* 


13 


EXIT(IT) 


Return from user's IT routine 


20* 


14 


STXIT{OC) 


Provide supervisor with linkage to user's OC routine for 
external or attention interrupts (operator comm.) 


21* 


15 


EXIT(OC) 


Return from user's OC routine 


22 


16 


SEIZE 


Seize/release system; enable/disable for external and 
I/O interrupts; set key in users PSW 


23* 


17 




Load phase header. Phase load address is stored at 
user's address 


24* 


18 


SETIME 


Set timer interval and provide supervisor with linkage 








to user's TECB, if any 


25* 


19 




Issue HALT I/O on a teleprocessing device, or HALT I/O 
on any device if issued by OLTEP. With multiprogramming 
dequeue an unstarted OLTEP I/O request to a shared 
device 


26* 


^A 




Validate address limits 


27* 


IB 




Special HIO on teleprocessing devices 


28* 


1C 


EXIT(MR) 


Return from user's stacker select routine (MICR type 
devices only) 


29* 


ID 


WAITM 


Provide support for multiple wait macro WAITM 


30* 


IE 


QWAIT 


Wait for a QTAM element 


31* 


IF 


QPOST 


Post a QTAM element 



Section 4, Chapter 6 

SUPERVISOR CALLS 



optional 



Figure 4.29 Supervisor Calls (Part 1 of 3) 
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SVC 
Dec 


Hex 


Macro Supported 


Function 


32 


20 




Reserved 


33 


21 




Reserved for COMRG macro 


34 


22 


GETIME 


Provides Time-of-Day and updates the DATE field 


35* 


23 


HOLD 


Hold a track for use by the requesting task only 


36* 


24 


FREE 


Free a track held by the task issuing the FREE 


37* 


25 


STXIT(AB) 


Provide supervisor with linkage to user's AB routine for 
abnormal termination of a task 


38* 


26 


ATTACH 


Initialize a subtask and establish its priority 


39* 


27 


DETACH 


Perform normal termination of a subtask. It includes 
calling the FREE routine to free any tracks held by the 
subtask 


40* 


28 


POST 


Inform the system of the termination of an event and 
ready any waiting tasks 


41* 


29 


DEQ 


Inform the system that a previously enqueued resource is 
now available 


42 


2A 


ENQ 


Prevent tasks from simultaneous manipulation of a shared 
data area (resource) 


43 


2B 




SDR SVC 


44* 


20 




Provide supervisor support for external creation of unit 
check records by specific request 


45* 


2D 




Provide emulator interface 


46* 


2E 




Provide OLTEP with the facility to operate in supervisory 
state 


47* 


2F 


WAITF 


Provide support for multiple wait macro for MICR type 
devices 


48* 


30 




Fetch a CRT transient 


49 


31 




Reserved 


!50 


32 




Reserved for LIOCS error recovery 


!51 


33 




Return phase header 


52* 
53 


34 
35 


TTIMER 


Return the remaining time interval, or cancel a time 

interval 

Reserved 


54 


36 


FREEREAL 




55 

56* 


37 
38 


GETREAL 


Provide interf. between SDAID and PDAID initialization 
routine and page management routine, to create the 
PDAID alternate area of the SD area 
Reserved 


57* 


39 




Reserved 


58 


3A 




jProvide interface between job control and the supervisor. 
Get real storage for real jobs 



.J^ 



optional 



Figure 4.29 Supervisor Calls (Part 2 of 3) 
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SVC 
Dec Hex 


Macro supported 


Function 


59 


3B 




Provide interface between EOJ and the supervisor. Reset 
the storage key for virtual jobs 


60 


30 


GETADR 


Provide virtual address of location within I/O areas for 
ERP and CRT routines 


61* 


3D 


GETVIS 


Get storage in virtual partition 


62» 


3E 


FREEVIS 


Free storage in virtual partition 


63 


3F 


USE 


Use a resource 


64 


40 


RELEASE 


Release a resource 


65 ♦ 


41 


ODLOAD 


Load VSAM or core image phase 


66 


42 


RUNMODE 


Return mode in which program is running 


67 • 


43 


PFIX 


Fix page(s) in real storage 


68* 


44 


PFREE 


Free page(s) in real storage 


69* 


45 


REALAD 


Return real address corresponding to a given virtual 
address 


70» 


46 


VIRTAD 


Return virtual address corresponding to a given real 
address 


71' 


47 


SETPFA 


Establish or terminate the linkage between the supervisor 
and a user page-fault appendage routine 


72 • 


48 


GETOBUF- 
FREEOBUF 


Get or free copy buffer for IDAL or tape ERP 


73* 


49 


SETAPP 


Allow linkage to channel and appendage routines 


74 » 


4A 




Fix page(s) in real storage for restart 


75 


48 




SEOTVAL Calculate value of sector for RPS 


76 


40 




Initiate RMS recording of an I/O error 


77 


4D 


TRANSOSW 


Returns the virtual address of a copied COW 


78 thru 84 




Reserved 


85 


55 


RELPAG 


Release contents of one or more pages 


86 


56 


FCEPGOUT 


Force a page-out for one or more pages 


87 


57 


PAGEIN 


Page in one or more pages 


90 


5A 


PUTAOOT 


Provide interface with POWER/VS for additional 
account information (by user). 


91 


58 




Provide interface with POWER/VS for standard 
account information (DOS/VS). 



* optional 
Figure 4.29 



Supervisor Calls (Part 3 of 3) 
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The PIB (program Information Block) 

Real storage area is reserved in the supervisor for this information block by the 
MPS multiprogramming and/ or NPARTS and AP (Asynchronous Processing) 
parameters of the SUPVR supervisor generation macro. Each entry in this block is 
16 bytes and contains status information about the program and, if AP is supported 
about the subtasks running in each partition supported by the supervisor. 

The first entry is reserved for the attention routine, this entry is called the 
Attention PIB (AR PIB). 

Other entries in the PIB belong to the problem programs and subtasks. The sum of 
all subtasks and problem program entries may not exceed 15. The maximum number 
of entries, including the attention PIB and AP (subtask) PIBs, is 16. 

For a supervisor that is not generated to support more than one partition there is 
only one 16-byte entry, which is shared by the attention routine and the 
problem program. 

By examining the data recorded in the appropriate PIB entry, the status and 
location of programs running in any partition can be established. Some of the 
more important data to be looked at in the PIB during the first analysis of a dump 
output are: 

• Byte 0, from which you can determine whether the program is waiting for 

• The LTA (Logical Transient Area), X'8 1' 

• The PTA (Physical Transient Area), X'85' 

• An I/O interrupt, X'82' 

• A page to be paged in, X'87' 

• A page to be paged in with QTAM active, X'8F' 

• Byte 4, X'80', which indicates that the job or task is running in virtual mode 

• The address of the program save area 

• The address of the system save area. 

Figure 4.30 (opposite) shows the format and describes the contents of an entry 
in the PIB. 






How to locate: 

Bytes X'5A' — X'5B' of the partition comregs contain the address of the first entry 
in this information block. Label PIBTAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB in a dump output. 
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PIBTAB 



Attention 


PtS 


Backgroun 


d PIB 


FG4 


PIB 


FQ3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 


L_ 






Subtask 


PIB 




Format of 
Attention PIB 
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f^! 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 
Byte 


Cancel 


SYSLOG 


always 


Inactive = zero 


Switch 


Address of save 


X'07' 


BG 


Number 


Not 




Code 


ID 
(AR) 


zero 


Active = Address 
of LTA save area 


Byte 


area of zero 


PIB 
assign 


user 
LUB 


of BG 
pro- 


used 




(See A) 








(Note 2) 


(See F ) 


(Note 1) 
(Note 2) 


flag 
(See D) 


index 


gram 
LUB's 







Note 1: a) When L TA is inactive= L TA save area address. 

b) When L TA is active for Problem Programs, this address is exchanged with that in the Problem Program PIB. 



Note: 



When L TA is active for Logical Attention, bytes 9-11 are zero and bytes 5- 7 contain the L TA save area address. 




Format of any 
Probl. Program 
or Subtask PIB 



Legend: A, B, C, D, E, F refer to next 
part of this figure, which 
describes the meaning of each 
bit in a PIB entry 






1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 


Cancel 


SYSLOG 


DAT 


Address of Problem 


Gate 


Address of sys- 


PIB 


User 


Number 


Flag 




Byte 


Code 


ID 


flag 


Program save area or 
LTA save area 


ID 


tem save area 


assign 
flag 


LUB 
index 


of 
Pro- 
gram 


Byte 




(See A ) 






(See B ) 


(Note 3) 


(See C ) 




(See D) 




LUB's 


(See E ) 





Note 3: When the Logical Transient Area is active the save area address in the Problem Program PIB is exchanged with that in the 
Attention PIB. 

The number of Problem Program PIBs generated depends on the number of partitions specified during system generation. 
Subtask PI Bs are generated only if AP= YES has been specified during system generation. 
The number of subtask PIBs generated depends on the number of partitions, that is: 



^ No. of partitions No. of subtasks 



Figure 4.30 Explanation of the contents of an entry in the PIB, 
part 1 of 3. 



13 
12 
11 
10 
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Flag Byte (First byte in PIB) 

The following flags are always used: 

X'71' = Program is waiting for SVC58 

X'73' = Program is waiting because system is seized 

X'75' = Program is waiting for copy block 

X'77' = Program is waiting for TFREE 

X'79' = Program is waiting for channel queue entry 

X'7B' = Program is waiting for CCW translation 

X'7D'= Program is waiting for a free Console Buffer 

X'80' = Program is not active 

X'81' = Program is SVC2-bound (waiting for the LTA to be released) 

X'82' = Program is SVC7-bound (waiting for an I/O interruption) 

X'83' = Program is ready to run 

X'85' = Program is SVC5-bound (waiting for the PTA to be released) 

X'86' = Initial selection of RAS (used only for HAS PIB flag) 

X'87' = Program is set to common bound condition 

The following flags are used only if NPARTS = 1. X'61' through X'69'are used 
by the load leveller to deactivate a partition. The partition to which a flag 
refers depends on NPARTS as follows: 









NPARTS - 








2 


3 


4 


5 


X'61' 


refers to 


BG 


BG 


BG 


BG 


X'63' 


refers to 


F1 


F2 


F3 


F4 


X'65' 


refers to 


- 


F1 


F2 


F3 


X'67' 


refers to 


- 


- 


F1 


F2 


X'69' 


refers to 


— 


— 


— 


F1 



X'6B' = Program is SVC35-bound 

X'6D'= Program is waiting for next freed page frame 

X'6F' = Program is IDRA-bound 

The following flags are only used if AP= YES: 

X'51' = Program is SVC38-bound 
X'53' = Program is SVC41 /42-bound 

The following codes are only used if AP= YES and PFIX= YES. 

The codes are used by the PFIX routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 



o 









NPARTS = 








2 


3 


4 


5 


X'47' 


refers to 


BG 


BG 


BG 


BG 


X'49' 


refers to 


F1 


F2 


F3 


F4 


X'4B' 


refers to 


- 


F1 


F2 


F3 


X'4D' 


refers to 


— 


— 


F1 


F2 


X'4F' 


refers to 


- 


- 


— 


F1 



The following codes are used only if AP= YES and VSAM= YES. 

The codes are used by the VSAM routines to set a partition PFIX bound. 

The partition to which a flag refers depends on NPARTS as follows: 

NPARTS = 



X'3D' refers to 
X'3F' refers to 
X'41 ' refers to 
X'43' refers to 
X'45' refers to 



BG 
F1 



BG 
F2 
F1 



4 

BG 
F3 
F2 
F1 



BG 
F4 
F3 
F2 

F1 



Figure 4.30 Explanation of the contents of an entry in the PIB, part 2 of 3. 
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B PIB DAT Flag 

X'01' = Return to re-entrant supervisor routine 

X'02' = Return to gated supervisor routine 

X'04' = Move CCB at dispatching time 

X'08' = Service delayed external interrupt 

X'10' = Task is temporarily deactivated 

X'20' = Reserved 

X'40' = Task has seized the system 

X'80' = Program is running in virtual mode 

C Gate Identifier 



X'71 ' = Gating of SVC58 required 
X'53' = Gating of SVC41 /42 required 

The flags are only used if the PIB DAT Flag is X'03', that is, the first two 
flags are on (See B ). 

D PIB Assign Flag 

X'80' = SYSRES DASD file protect inhibited (allow write operation on SYSRES) 

X'40' = Channel appendage exit allowed (BTAM) 

X'20' = Cancel in progress (used in terminator function) 

X'10' = Cancel control (set on a foreground cancel) 

X'08' = Hold foreground assignments 

X'07' = Attention PIB 



E Problem Program PIB Flag (Last byte in PIB) 



1= Batched job in foreground (always on when tested) 
1= Cancel in LTA and device not assigned 
1=/&on SYSIN if DASD 
1= Partition in stopped state 
1= Fetch EOJ monitor 
1= Task is canceled 
1= Subtask(s) attached 
1= in AB routine 



Attention PIB Switch Byte 



Reserved 

Reserved 

1= Delay cancelation 

1= Emergency cancel request 

1= Detach Logical Attention Routine (SSBATTNA) 

Reserved 

1= Fetch Logical Attention Routine (SSBATTNA) 

1= External Interrupt request 
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Figure 4.30. Explanation of the contents of an entry in the PIB, part 3 of 3 
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Section 4, Chapter 7 

PIB AND PIB2 PIB2 (Program Information Block Extension) 



As the name of this block implies, it is an extension of the FIB and is of identical 
size, being generated with the PIB during system generation. Data recorded in each 
16-bytes entry supplements the data recorded in the PIB. 

By examining the contents of bytes and 1 of the appropriate problem program 
PIB2 entry, the address of the associated partition communication region can be 
established. 



How to locate: 

Bytes X'7C' - X'7D' of the partition comregs contain the address of the first entry 
in this information block. Label PIB2TAB in the supervisor Hsting identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB2 in a dump. 



/if V, ■ 
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PIB2TAB 



Attention 


PIB 


Backgroun 


dPIB 


FG4 


PIB 


FG3 


PIB 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 


r=="^ 


Subtask 


PIB 



Format of any 
PIB extension 
entry 
1 2 



3 4 



7 8 



10 



11 12 



13 14 



15 



16-bit 














Address of com- 


System 


Interrupt 


Address of termination ECB 


Program 


un- 


Flag 


munication 


LUB index 


Information 


if any, otherwise zeros 


Interrupt 


used 


Byte 


region of 








Key (PIK) 




(See 


partition 












B 


(Note 1 ) 




(See table A below) 








below) 



Note 1: Always BG communication region in Attention— and Baclcground PIB extension. Appropriate communication region in other 

PIB extensions when a multiprogram system has been generated. To place this address in a register, the instruction ICM should 

be used. 

For each PIB Table entry, an entry exists in the PIB Table Extension. 



Type of interruption 


Contents of PIB Extension Bytes 


4 


5 


6 1 7 


SVC 
PC 

I/O 


00 
00 
00 


ILC* 
ILC* 
00 


Interruption Code 
Interruption Code 
I/O Address 



Byte 14 



Not used 



Byte 1 5 



Bit 1 : Not used 
Bit 2: 1 =Task owns CRT 
3-7: Not used 



ILC (Instruction Length Code) is in bits 5 and 6; other bits are zeros. 



Figure 4.31. Explanation of the contents of an entry in the PIB2 
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CANCEL CODES 



Byte 1 of the PIB contains a cancel code that is stored by the supervisor in the 
event of program cancellatioa. Normally a message is printed on SYSLOG and/or 
SYSLST that informs the operator about the reason for the cancellation, for 
example: 

BG 0S04I ILLEGAL SVC - HEX LOCATION 007884 - SVC CODE 14 

The cancel code (stored in byte 1 of the associated partition PIB) should be 
examined also in the event of a system malfunction such as a LOOP or WAIT STATE 
that prevents the system from issuing an error message. 

Figure 4.32 (below) shows a list of all the cancel codes and their message prefixes. 

All these cancel codes cancel the program, task, or subtask when they occur. If 
multitasking is being used and a main task is canceled, all of the subtasks attached 
are detached and canceled as a result of the main task being canceled. If a dump 
option was specified at system generation time or by job control, the contents of 
the supervisor and the partition in which the cancel condition occurred is printed 
on SYSLST. 



/O^ 



Cancel 
Code (hex) 


Message 
Code 


Descriptive part of Message 
or Condition 


10 




Normal EOJ 


11 


0V07I 


No channel progrann translation for unsupported device 


12 


0V06I 


Insufficient buffer space for channel program translation 


13 


0V051 


CCW with count greater than 32 K 


14 


0V04I 


Page pool too small 


15 


0V02I 


Page fault in disabled program 


16 


0V011 


Page fault in MICR stacker select or PHO routine 


17 


0S02I 


Program request (Same as 23 but causes dump because subtasks 
were attached when maintask issued CANCEL macro) 


18 




Eliminates cancel message when maintask issues DUMP macro 
with subtasks attached 


19 


0P74I 


I/O operator option 


1A 


0P73I 


I/O error 


IB 


0P82I 


Channel failure 


1C 


0S14I 


CANCEL ALL macro 


ID 


0S12I 


Main task termination 


IE 


0S13I 


Unknown ENQ requestor 



Figure 4.32. DOS/VS Cancel Codes and Messages, part 1 of 2. 
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Cancel 


Message 


Descriptive part of IVIessage 


Code (hex) 


Code 


or Condition 


IF 


0P81I 


CPU failure 


20 


0S03I or 
0S11I 


Progrann cineck 


21 


0S04I or 
0S09I 


Illegal SVC 


22 


0S05I or 
0S06I 


Phase not found 


23 


0S02I 


Program request 


24 


0S01I 


Operator intervention 


25 


0P77I 


Invalid address 


26* 


0P71I 


SYSxxx not assigned (unassigned LUB code) 


27 


0P70I 


Undefined logical unit 


28 




QTAM cancel in progress 


29 


0S15I 


No relocating loader support (Fetch or load request for 
relocatable phase while supervisor does not support relocating 
load) 


2A 


0P84I 


I/O error during fetch (irrecoverable I/O error during fetch 


2B 


0V10I 


I/O error on page data set 


2C 


0V09I 


Illegal parameter passed by PHO routine 


2D 


0P881 


Program cannot be executed/restarted due to failing storage block 


2E 


0S16I 


Invalid resource request (possible deadlock) 


2F 


0V03I 


More than 255 PFIX requests for 1 page 


30 


0P721 


Reading past /& statement (on SYSRDR or SYSIPT) 


31 


0P75I 


I/O error queue overflow (error queue over-flow) 


32 


0P76I 


Invalid DASD address 


33 


0P79I 


No long seek (disk) 


34 




Reserved 


35 


0P85I 


Job control open failure 


36 


0V08I 


Page fault in I/O appendage routine 


37 




Reserved 


38 


0V11I 


Wrong privately translated CCW 


39 




Reserved 


FF 


0P78I 


Unrecognized cancel code 




0P83A** 


Supervisor catalog failure 




0P87A** 


IPL failure 
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o 



Figure 4.32. DOS/VS Cancel Codes and Messages, part 2 of 2. 

* if the CCB is not available, the logical unit is SYSxxx. 

** The cancel code is not significant in case of a supervisor catalog or IPL failure, because 
the system is placed in the wait state without any further processing by the Terminator. 

Note: In addition to recognizing the cancel codes above, the Terminator also recognizes the 
same codes with the X'80' bit on (cancel occurred in L TA). The X'80' bit is tested by 
^^BEOJ and subsequently reset. 
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GENERAL PURPOSE 
REGISTER USAGE 



The following paragraphs describe the general usage of registers 0, 1, 13, 14, and 15 
by IOCS, but the description is not meant to be all-inclusive. 

Registers and 1: Logical IOCS macros, the supervisor macros, and other IBM- 
supplied macros use these registers to pass parameters. Therefore, these registers 
may be used without restriction only for immediate computations, where the 
contents of the register are no longer needed after the computation. If you use them, 
however, you must either save their contents yourself (and reload them later) or 
finish with them before IOCS uses these registers. 

Register 13: Control program subroutines, including logical IOCS, use this register 
as a pointer to a 72-byte doubleword-ahgned save area. When using the CALL, 
SAVE, or RETURN macros, you can set the address of the save area at the beginning 
of each program phase, and leave it unchanged thereafter. However, when sharing 
a reenterable (read only) logic module among tasks, each time that module is 
entered by another task, register 13 must contain the address of another 72-byte 
save area to be used by that logic module. 

Registers 14 and 15: Logical IOCS uses these two registers for linkage. Register 14 
contains the return address (to the program) from DTP routines, called programs, 
and your subroutines. Register 15 contains the entry point into these routines, and 
is used as a base register by the OPEN (R), CLOSE (R), and certain DTP macros. 
IOCS does not save the contents of these registers before using them. If you use 
these registers you either save their contents yourself (and reload them later) or 
finish with them before IOCS uses them. 






Registers for Your Use 

Registers 2-12 are available for general usage. There are, however, a few restrictions. 

The assembler instruction for translate and test (TRT) makes special use of 
register 2. It is your responsibihty to save the contents of this register before 
executing the TRT instruction if register 2 contains valuable information (such as 
pointers or counters) for later use in your program. After the TRT instruction has 
been executed, you can then restore the contents of register 2 from the save area. 

If an ISMOD logic module precedes a USING statement or follows your program, 
the use of registers 2-12 remains unrestricted even at assembly time. However, if 
the ISMOD logic module lies within the problem program, you should issue the 
same USING statement (which was issued before the logic module) directly follow- 
ing the logic module. This action is necessary because the ISMOD logic module 
uses registers 1 , 2, and 3 as base registers, and the ISMOD CORDATA logic module 
uses registers 1, 2, 3, and 5 as base registers. Each time either module is assembled, 
these registers are dropped. 



\J 
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Register usage by JOB ACCOUNTING GENERAL PURPOSE 

''h REGISTER USAGE 

(The Job Accounting option is discussed in Chapter 13 of this Section) 

The system passes registers 11-15 to the user's I/O routine ($JOBACCT). These 
registers contain the following information: 

• Register 1 1 : Length of the job accounting table. Each table may vary in 
length according to the number of SIO counts specified at system generation 
time. 

• Register 12: Base register for $JOBACCT (this eliminates the need for the 
user to load the base register) 

• Register 13: Address of the user save area 

• Register 14: Link register ($JOBACCT must exit via BR 14 to return to 
job control) 

• Register 15: Address of the partition's job accounting table. 
Because some of the job step information is cleared in the step-to-step transition, 
job control calls $JOBACCT at the end of each step. If $JOBACCT does not save 
or accumulate this information, it is lost. 



c 
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Linkage Registers 

To standardize branching and linking, registers are assigned specific roles (Figure 
4.33). Registers 0, 1, 13, 14, and 15, are known as the linkage registers. Before a 
branch to another routine, the calling program is responsible for the following 
calling sequence: 

1. Loading register 13 with the address of a register save area in the program 
that the called program is to use 

2. Loading register 14 with the address to which the called program will return 
control 

3. Loading register 1 5 with the address from which the called program will 
take control 

4. Loading registers and 1 with parameters, or loading register 1 with the 
address of a parameter list. (Although permissible, it is not normal to load 
register with parameters). 






Register 
Number 


Register Name 


Contents 





Parameter register 


Parameters to be passed to the called 
program. 


1 


Parameter register 

or 

Parameter list 
register 


Parameters to be passed to the called 
program. 

Address of a parameter list to be 
passed to either the control program 
or a user's subprogram. 


13 


Save area register 


Address of the register save area to be 
used by the called program. 


14 


Return register 


Address of the location in the calling 
program to which control should be 
returned after execution of the 
called program. 


15 


Entry point register 


Address of the entry point in the 
called program. 



Figure 4.33 Linkage Registers 



After execution of the calling sequence, the following should occur as a result of 
called program execution: 

1. The contents of registers 2 through 14, and the program mask are unchanged. 

2. The contents of registers 0, 1 and 15, the contents of the floating point 
registers, and the condition mode may be changed. 

3. The parameter list addresses contain the results obtained by the execution 
of the called program. 



xy 
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When support is provided during system generation for user exit routines (other 
than VSAM exit routines), an area is reserved in the supervisor for one or more of 
the following tables: 

• Interval timer (IT") 

• Abnormal termination (AB) 

• Page fault handling overlap (PHO) 

• Program check (PC) 

• Operator communication (OC). 

Entries in the table are generated from the STXIT macro issued by the problem 
program, and the number of entries depends on the number of partitions for 
which the system has been generated. 

The number of entries for the PC and AB tables is increased by the number of 
subtasks allowed on a system generated for use with multitasking. 



Section 4, Chapter 10 

TABLES REQUIRED BY 
USER EXIT ROUTINES 
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Interval Timer Support (IT) 

This parameter generates programming support for the hardware interval timer 
feature, which is used to time-stamp the system. It enables a problem program to 
set a time interval (via the SETIME macro). 

By using the STXIT, EXIT, and TECB macros, a specific routine within the problem 
program or task is entered when this time interval elapses. 

How to locate the IT option table 

Bytes X'66'-X'67' of the partition communication regions contain the address of 
the IT Option Table. Label ITTAB identifies the first byte of the table. 



ITTAB 



See 
Note 



V 



BG 



F4 



F2 



F1 



Subtask 



Subtask 



Subtask 



34 



TECB 



Save Area 



Address 



/ 



Compl. of T ECB 
Save Area . 



Address 



/ 



\ 



/ 



\ 



/ 



/ 



/ 



/ 



\ 



\ 



\ 



/ 






\ 


Bytes 0-3: 


No TECB or STXIT 








issued 


zero 






TECB issued 


Address of the timer event control block 






STXIT issued 


Address of user interval timer routine 






STXIT issued and 








user routine is 








already in use 


Complement of the user interval timer routine 




Bytes 4-7: 


No TECB or STXIT 








issued : 


zero 






TECB issued 


Complement of the TECB address 






STXIT issued 


Address of the user save area 





4" 
1_ 



Note: One table entry is built for each partition and an IT Request table is also built. 

With multiple timer and asynchronous processing supported, the table always 
comprises 15 entries; the subtask entries occupy the higher address locations 
in the table. 



Figure 4.34. Explanation of the contents of the IT option table. 



o 
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Interval Timer Request Table 

This table is generated only for systems supporting the interval timer option 
(IT= YES). It is used in conjunction with the IT option table described in 
Figure 4.34. 

The number of entries is one more than the number of partitions supported, but 
with multiple timer and asynchronous processing supported, the table always 
comprises 16 entries. 
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How to locate the IT request table 

Bytes X'50'-X'53' of the System Communication region (SYSCOM) contain the 
address of the IT Request Table. Label ITREQ identifies the first byte of the 
table. 



ITREQ 



r 



See 
Note 



< 



KJ 



1 



Task 
Identifier 



— ' 1 r 

Time Interval 



\ 



/ 



\ 



\ 



00 FF 00 00 00 



/ 



\ 



/ 



\ 



/ 

/ 




\ 
\ 


Byte : 


No SETI ME issued : 


X'OO', the last entry is always X'OO'. 




SET! ME issued 


PIK or TIK (X'10-X'FO') of the program or task 
that issued the SETIME macro. 


Bytes 1-4: 


No SETIME issued : 


Highest time interval possible (X'FFOOOOOO'). 
The last entry is always X'FFOOOOOO'. 




SETIME issued : 


Time interval that will elapse between the occurrence 
of the currently pending interrupt in SYSTIMER and 
the occurrence of the interrupt itself. The entries are 
in ascending order of hnagnitude, that is, the smallest 
interval appears first. 

The interval corresponding to the currently pending 
interrupt is in SYSTIMER (address X'50') and the 
key of the respective program or task is in TWTIMS. 



%^^ Figure 4.35. Explanation of the contents of the IT option request table. 
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Abnormal termination support (AB) 

Abnormal termination exits are available for main tasks and/or subtasks, allowing 
you to gain control before an abnormal condition removes the task from the 
system. For example, in the abnormal termination routine, you can close your 
files. This function is provided by the AB operand of the STXIT macro. See 
Supervisor and I/O Macros for detailed information on the format and use of the 
STXIT macro. 






How to locate: 

Bytes X'54'-X'57' of the System Communication region (SYSCOM) contain the 
address of the AB Option Table. Label ABTAB identifies the first byte of the 
table. 



ABTAB 



See . 
Note '^ 



V- 



BG 



F4 



F3 



n 



F1 



Subtask 



Subtask 



Subtask 



3 4 



1 1 1 

AB Routine Address 



1 1 1 

Save Area Address 



/ 



/ 



\ 



\ 



\ 



/ 



\ 



\ 



/ 



\ 



/ 



\ 



/ 



Bytes 0-3: No STXIT issued 

STXIT issued and 
rtnaddr parameter 
passed 



Bytes 4-7: 



No STXIT issued 
or no save area 
parameter passed 

STXIT issued and 
save area para- 
meter passed 



Zero. 



Address of entry point of user's abnormal termination 
routine. If AP (Asynchronous Processing) is supported 
the maintask and subtasks may have the same or 
different AB routines. When a subtask is ATTACHed 
after a STXIT AB macro has been issued by the 
maintask, the subtask will receive the AB routine 
address specified by the maintask only if the 
ATTACH macro for that subtask has the ABSAVE 
parameter specified. The subtask can override this 
by issuing its own STXIT AB macro. 



Zero. 



Address of a 72-byte save area used by the supervisor 
to store the interrupt status information and the 
contents of the general registers. (See Chapter 12.) 






Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 



Figure 4.36. Explanation of the contents of the AB option table. 
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Page Fault Handling Overlap Support (PHO) 

This option enables a user routine to continue processing during the time a page 
fault, occurring in the same task, is being handled, PHO=YES in the SUPVR 
supervisor generation macro reserves an area in the supervisor for the PHO option 
table. Entries are made in this table when the user program issues a SETPFA macro 
instruction. The SETPFA macro instruction is described in DOS/ VS Supervisor 
and I/O macros. If asynchronous processing (AP) is not supported, one entry is 
generated in the table for each partition supported by the system (NPARTS). If 
AP is supported, 15 entries are generated. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 






How to locate: 

Label PFATAB in the supervisor listing identifies the first byte of this table. 

PFATAB 



See 
Note 



< 



V. 



BG 



F4 



F3 



F2 



F1 



Subtask 



Subtask 



Subtask 



3 4 



PHO 
Routine Address 



/ 



u 



Page Fault Information 



Flag Byte 



\ 



\ 



\ 



\ 



/ 



\ 



/ 



\ 



\ 



/ 



/ 



\ 



SETPFA issued 



Byte : Bit : 1= A page fault fronn the task is in the Page Queue Table. 

Bit 1 : 1= A page fault occuring in a supervisor service of the task is 

queued in the Page Queue Table. 

Bits 2-7: Unused. 

Bytes 1-3: Address of the user's page fault appendage routine. 

Bytes 4-7: Page fault information (for detailed layout see Page Queue Table). 

This information is stored here only when a page fault occurs in a supervisor 
service working for the task, while another page fault is queued for the 
task in the Page Queue Table; otherwise, zeros. 

NO SETPFA issued 



Bytes 0-7: Zeros. 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 

PFA TAB is only built ifPHO=YES was specified in the SUPVR macro at supervisor 
generation. 
Figure 4.37. Explanation of the contents of an entry in the PHO option table. 
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Program check support (PC) 

Program check (PC) support generates a PC table within the supervisor (see the 
Figure below). The address of a user program check routine is placed in the table 
via the STXIT macro issued by the problem program. If the STXIT PC linkage is 
established and a program check occurs within this program, the supervisor gives 
control to the user's routine instead of canceling the job being run in this partition. 
The support is extremely advantageous when using LIOCS. (For example, files can 
be closed before job termination.) If a program check occurs in a routine being 
executed from the logical transient area (LTA), only the task associated with that 
routine is abnormally terminated. 



In a multitasking environment each subtask and main task may have its own PC 
routine. A PC routine can be shared by more than one task within a partition. This 
can be done issuing a STXIT macro in each task with the same routine address but 
with separate save areas. To successfully share the same PC routine, it must be 
reenterable (capable of being used concurrently by two or more tasks). 



How to locate: 

Bytes X'64'— X'65' of the partition communication regions contain the address of 
the PC Option Table. Label PCTAB identifies the first byte of the table. 



PCTAB 



See 
Note^A 



BG 



F4 



F3 



F2 



F1 



Subtask 



^ 



Subtask 



Subtask 



PC Routine Address 



Save Area Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 







\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued 


: Address of the user Progrann Check Routine. 




STXIT issued and 






the user routine 






is already in use 


Complement of user Program Check Routine address. 


Bytes 4-7: 


No STXIT issued 


: Zero. 




STXIT issued 


Address of the user Save Area. 






Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. With multiprogramming support, there is one entry for each partition 
supported. 

With asynchronous processing support, each generated table always comprises 15 entries; 
the subtask entries occupy the higher address locations in the table. 

Figure 4.38. Explanation of the contents of an entry in the PC option table. 



o 
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Operator communications support (OC) 

Operator Communications (OC) refers to the processing of an external interrupt 
by a problem program. In a multitasking environment, only the main task can 
communicate via the OC linkage. By specifying OC=YES, a table (OC option table) 
is generated within the supervisor (see Figure below). When the problem program 
issues the STXIT macro, the address of its external interrupt routine is moved to the 
OC option table. The user's routine is terminated by issuing the EXIT macro. When 
OC=YES is specified, support is available to all partitions. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 



o 



o 



How to locate: 

Bytes X'68'-X'69' of the partition communication regions contain the address of 
the OC Option Table. Label OCTAB identifies the first byte of the table. 



See I 
Note S 



OCTAB 



BG 



F4 



F3 



F2 



F1 



Subtask 



Subtask 



Subtask 



OC Routine Address 

I I I 



1 1 1 

Save Area Address 



\ 



/ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



/ 




\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Operator Comnnunication 
Routine. 




STXIT issued and 






the user routine 






is already in use 


Complement of the user Operator Communication 
Routine 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Save Area. 



Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. 

With multiprogramming support, there is one entry for each partition supported. 
With asynchronous processing support, each generated table always comprises 
15 entries; the subtask entries occupy the higher address locations in the table. 

Figure 4.39. Explanation of the contents of an entry in the OC option table. 
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Partition Save Areas and Label Save Areas 

Each partition contains a save area for program name, old program status word, 
and registers. 

Following the partition save area, each partition contains a label area for label 
processing if the LBLTYP statement is used. Both areas are at the low end of the 
partition. 

Save area length = 88 (dec) bytes or, if the floating point feature is supported, 
120 (dec) bytes (FP=YES specified in the CONFG system generation macro). 

Label area length is determined by the system according to the LBLTYP card 
specification: 

• TAPE (standard tape labels) = 80 bytes 

• NSD (nn) (nonsequential disk) = 84 bytes + 20 bytes per extent statement 

• Omitted = 0. 

Figure 4.41 (opposite) illustrates the location of the partition and label save areas 
in virtual storage for a system supporting multiprogramming. The figure below 
shows an example of a background program partition, save area as it is printed in a 
system dump. The programmers remarks on the figure indicate how the programmer 
used the save area during offline debugging. 




c 



Figure 4.40. An example of a system dump output showing the partition save area. 

The programmer's remarks on the dump show areas of immediate interest during 
offline debugging. 



How to locate: 

The addresses of the partition save areas are stored in the problem program PIB, 
described in Chapter 7 in this Section, 



> 
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SPVR <, 



BG 



FG 



> 



< 



> 



< 



Supervisor Area 



Background jarogrann save dtm. 



l^bei save area. iSm note 1 1 



Background program area. 



f=oregrouod program save ar^a. 



save area, (See n<5te 1 }, 



Foreground program area. 




Other foreground program save areas. 



label save areas. 



and program areas have 
similar layouts. 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 

9 through 8 (64 bytes) 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2 



Floating Point Registers 
32 bytes 
(See note 3) 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 9 through 8 
64 bytes 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2. 



Floating Point Registers 
32 bytes 
See note 3. 



o 



Note 1: Length of the label area depends on the amount of storage specified by LBLTYP 
statement: 



A. 
B. 
,C. 



For standard tape labels (any number)-80 Bytes 

For sequential DASD and DTFPH MOUNTED SINGLE-0 Bytes 



For DTFIS, DTFDA and DTFPH MOUNTED ALL-84 Bytes plus 20 Bytes 
per extent. 
Note 2: Job start time, for time stamp, is stored in last 4 bytes of this area. 
Note 3: Floating point register save area is required only when floating point feature is 

specified at supervisor generation. 
Note 4: Only non-zero if a // LBL TYP statement read before the current job step. Otherwise 
reserved by the linkage editor, but not entered in these bytes. 

Figure 4.41 . Organization of partition save and label save areas. 
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ABSAVEarea 

In all abnormal termination conditions where an exit is taken to an abnormal 
termination routine specified and written by the user, the register values are stored 
in the ABSAVE save area before the appropriate error code is stored in the low- 
order byte of register 0. To have this value available when looking at a storage 
dump you should store (STC or ST) register in another save area upon entry into 
the abnormal termination routine. You will find that the SVC code shown in the 
"0S04I ILLEGAL SVC— ..." message along with the error codes in register 
will be helpful in tracing program errors. Each user exit routine must have its own 
save area in order to preserve the contents of the 16 general registers and interrupt 
status information at the time the exit routine is entered. The address of the save 
area is specified in the STXIT macro and is contained in the appropriate option 
table. 

Figure 4.42 (opposite) illustrates the format and contents of the Interrupt Status 
Information (the first 8 bytes of the save area). Details about the STXIT macro 
can be found in DOS /VS Supervisor and I/O macros, and details about the option 
tables in the DOS/VS Supervisor Logic. 



fW W\ 



V„y 
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Exit Routine 



STXIT 




General 

Registers 

0-15 



X'48' byte save area 
for user exit routines 
IT, PC, AB,OC. 
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IIIIH^^^^^^^^ 


Reserved 


Key 


1 

MWP 


^ Interruption Code 


ILC 


CC 


Program 
Mark 


Instruction Address 



^k^gi^nt 1 



't 12 is always set to 1 
Bit 1 3 if set to 1 , enables machine check interrupt 
Bit 14 if set to 1 , indicates CPU wait state. 
Bit 15 if set to 1 , indicates CPU in problem state 
if set to 0, indicates CPU in supervisor state 



Interrupt codes j 
for PC; S 



Interrupt code 
for IT: 

Interrupt codes 
for OC: 



Always 
X'OO' 



'01' 
'02' 
'03' 
04' 
'05' 
'06' 
07' 
08' 
09' 
OA' 
OB' 
OC 
OD' 
OE' 
OF' 
10' 
11' 
12' 
13' 
40' 
8x' 



X'80' 
X'40' 



Cause of Program 
Interrupt 

00000001 Operation 

00000010 Privileged operation 

0000001 1 Execute 

00000100 Protection 

00000101 Addressing 

00000110 Specification 

000001 1 1 Data 

00001000 Fixed point overflow 

00001001 Fixed point divide 

00001010 Decimal overflow 

00001 01 1 Decimal divide 

00001 1 00 Exponent overflow 

00001 1 01 Exponent underflow 

00001110 Significance 

00001111 Floating-point divide 

00010000 Segment translation 

00010001 Page translation 

00010010 Translation specification exception 

00010011 Special operation exception 
01000000 Monitor call 

ixxxxxxx PER event, where x = code 

for cause of program 

10000000 Timer check. For example, a 

PER + a data exception 

01000000 External = X'87' (100001 1 1 ). 



o 



Figure 4.42. The format and contents of the user exit routine save area and 

interrupt status information. 
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SAVE AREAS System Save Areas (for system tasks) 



There are occasions when task information must be saved by the page manager. 
For example, page faults may occur when supervisor services are executed under 
control of user PIBs. Because the user's partition save area is occupied during this 
time, an additional system save area for each user task is provided. 

The information saves is contained in a 72-byte (dec) field, and includes the return 
PSW and 16 general purpose registers belonging to the interrupt supervisor task. 
The registers are stored in numerical sequence beginning with GR9. The save areas 
for all tasks (maximum of 15), are within the supervisor area. The address of each 
user task save area is recorded in the program information block. (Refer to Chapter 
7 in this Section.) 

Immediately following each save area is an area reserved for the CCW/TCB (Channel 
Command Word/Translation Control Block), the format and contents of which is 
described in Chapter 1 3 in this Section. The addresses of system (task) save areas 
are contained in the system communication region, refer to Chapter 2 in this 
Section. 



1^1 



1 
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Save Areas for the Job Accounting option 

If the J ALIOCS parameter is specified in the FOPT supervisor generation macro, 
two save areas are reserved in the supervisor. 



JALIOCS= 



NO 

(s, 1) 
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SAVE AREAS 



NO indicates that no special LIOCS support is required. Specification of (s, 1) 
indicates that a user save area and a label area are to be reserved. 

S is the decimal number of bytes to be reserved for the user save area (located in 
the supervisor). This save area may be used to save DTF information or for any 
other purpose desired by the user. The system does not access this area. (The 
address of the save area is available in register 13 when $JOBACCT is called.) 
The vaUd range of s is 0-1024, with a default of 16. 1 is the decimal number of 
bytes needed for a label area. This label area replaces the one normally used by 
LIOCS label processing. It is required when $JOBACCT uses LIOCS for such 
things as standard tape labels, DTFDA, and DTFPH with MOUNTED=ALL. The 
valid range of 1 is 0-224, with a default of zero. The value that is substituted for 
1 is normally the number of bytes that would be allocated by a given parameter 
on the LBLTYP statement. See Figure 4.41 in this Section to determine 
the number of bytes allocated for any given LBLTYP statement. 

If the JA parameter is specified and JALIOCS is not the job accounting interface is 
generated but no alternate label area is reserved (16 bytes are reserved for the 
save area). The routine $JOBACCT must then use a device or method that does 
not require LIOCS label programming. If the JA parameter is not specified, the 
JALIOCS parameter is ignored. 
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PAGE MANAGEMENT 
TABLES 



The purpose of this chapter is to describe the tables that are used by the page 
management routines which may need to be inspected during program debugging. 
A knowledge of the concept of virtual storage is assumed. 



The Segment Table 

One segment table is generated within the supervisor area during system generation. 
Each entry in the segment table corresponds to one 64K segment of virtual storage. 






How to locate: 

The address of the first entry in the segment table is contained in bytes X'DO' to 
X'D3' of SYSCOM. Label STAB in the supervisor listing identifies the address of 
the first byte of the segment table. The address of the segment table is also 
contained in control register 1. Refer to the example shown in Figure 4.47. 



The Page Table 

One page table is generated for each segment of virtual storage during system 
generation. Each page table is 64 (decimal) bytes in length, and has 32 two-byte 
entries. Each entry corresponds to 2048 (decimal) bytes of virtual storage. As 
illustrated in Figure 4.46, the page tables occupy a consecutive area in the 
supervisor. 



Initialization of the Page Table 

After IPL, page table entries are initialized as follows: 

• All page table entries belonging to the supervisor area (nucleus and 
transient areas): 

Bit 13 = 

Bit 15 = 

Bits 0- 12 = the leftmost 13 bits of the address of the corresponding 

page frame. 

• All page table entries for allocated real partitions: 
Bit 13 = 

Bit 15= 1 
Bit 0=1 
Bits 8-11= storage key of the partition. 

• Page table entries belonging to virtual partitions: 
Bit 13 = 1 

Bit 15=1 
Bit 0=0 
Bits 8-11 = storage key of corresponding partition. 

• All remaining page table entries: 
Bit 13 = 

Bit 15= 1 
Bit 0=1 
Bits 1-12 = 






( 



y 
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How to locate 

The address of the page table belonging to the first 64K of virtual storage is 
contained in the first entry in the segment table. 

The address of the page table belonging to subsequent segments of virtual storage 
are contained in the associated segment table. Refer to Figure 4.46 which illustrates 
this. 

Appendix G shows an example of locating the segment table and page table in a 
dump. 

Figure 4.43 (below) shows the format and contents of an entry in the segment 
table and an entry in the page table. The figure also illustrates the interconnection 
between these two tables. 



STAB (Segment table) 



X'FO' 



X'FO' 



X'FO' 



X'FO' 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Each entry in the 
segment table 
corresponds to one 
64 K segment of 
virtual storage. 

One page table is 
built for each seg- 
ment of virtual 
storage and W 

contains 32 two-byte 
entries. 



PT (Page Table) 



PAGE MANAGEMENT 
TABLES 



Bytes and 1 


: BitO 


2s». 

: 1 = Address of any byte in the corresponding page 
is invalid, that is the page is not in real storage 




Bits 0-1 2 


Leftmost 1 3 bits of address of page in real storage 
if bit 13=0. 




Bits 8-11 


: Storage key of corresponding partition if bit 13= 1 . 




Bit 13 


= Page is in real storage; 

1 = Page is not in real storage. 




Bit 14 


: Always zero. 




Bit 15 


: = Page must be read from page data set, (a valid 
copy of the page is on SYSVIS); 

1 = Page need not be read from page data set, (there 
is not a valid copy of the page on SYSVIS). 



Note: Label STAB identifies the first byte of the table 

Label PT identifies the first byte of the Page Table. 



o 



Figure 4.43. Explanation of the contents of an entry in the Page Table. 

This figure also illustrates the relationship between the page table and the segment table. 
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Page Frame Table 

The page frame table is built at supervisor generation time and contains one 8-hyU 
entry for each 2K block of real storage (page frame) as specified in the RSIZE 
parameter of the VSTAB macro. 



/4' ^ 



How to locate: 

Bytes X'D4-X'D7' of the SYSCOM contain the address of the first entry in this 
table. Label PFT in the supervisor listing identifies the address of the first byte 
of this table. 

The format and contents of an entry in the page frame table is shown belov^. 






1 


2 


3 


4 


5 


6 


7 



\ 



\ 



\ 



\ 



\ 



Bytes and 1 



Bits 0-10 
Bit 11 
Bit 12 
Bit 13 
Bit 14 
Bit 15 



Bytes 2 and 3: 



Bytes 4 and 5: 



Bytes 6 and 7: 



Counter for temporary fixes (tfix counter.) 

Reserved for later use. 

1= PFIX request (into another page frame) pending for the page. 

If on, page frame is unusable (hardware failure). 

If 0, page frame belongs to selection pool 

1= PFIX (different page) or GETREAL request pending for the page frame. 

Pointer to next page frame in queue or to queue header if last element 
in the queue (all page frames in selection pool are queued). 

If the frame is occupied, the page number (The virtual address of the 
page divided by 2048); if unused, X'FFFF'. 

Pointer to the previous frame in the queue or to queue header if first 
element in the queue (all page frames in the selection pool are queued). 



Figure 4.44. Explanation of the contents of an entry in the Page Frame Table. 

Page frame table extention (PFTX) 

This table is a one-byte appendage to each entry in the page frame table. It serves 
as a counter for the number of times a page has been permanently fixed in a page 
frame, and is labeled PFIX counter. 

How to locate 

Bytes X'D8' - X'DB' of SYSCOM contain the address of the first entry in this 
table. Label PFTX in the supervisor listing identifies the address of the first byte 
of this table. 






\J 
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Boundary Box 

This information block is generated in the supervisor during system generation. 
The area occupied by the boundary box is sufficient to contain up to six entries, 
depending on the number of partitions specified during system generation. The 
first entry contains information about virtual storage allocation, and the remaining 
entries contain information pertaining to each partition supported by the supervisor. 
If a partition is not supported by the supervisor, the beginning and end addresses 
are identical to those of the next partition. 



PAGE MANAGEMENT 
TABLES 









How to locate: 

Bytes X'DC - X'DF' of SYSCOM contain the address of the first entry in this 
information block. Label BBOX in the supervisor listing identifies the address of 
the first byte of this information block. Appendix G shows an example of locating 
the boundary box in a dump. 

The format and contents of the boundary box is shown below: 



3 


4 5 


6 7 


8 11 


12 


15 


End Address of Real Storage 


Number of 


Number of 








or Address of Alternate Area 


Page Frames 


Page Frames 


Begin Address of Virtual 


End Address of Virtual 




for PDAID or the start 


in smallest 


In Main Page 


Address Area 


Address Area + 1 




of the SD area for SDAID 


Real Partition 


Pool 









Format of the 
General Entry 



BBOX 



General Entry 


BG Entry 


F4 Entry 


F3 Entry 


F2 Entry 


F1 Entry 



■^ 



> 



The number of entries is equal 

to the number of partitions (NPARTS) 

specified at system generation + 1 . 



3 4 



Format of 
any entry 
7 8 



11 12 



-15 



Begin Address of 
Real Partition 



End Address of 
Real Partition + 1 



These values are inserted at IPL time but can be changed 
by ALLOCR command. 



Begin Address of 
Virtual Partition 



End Address of 
Virtual Partition + 1 



These values are inserted at system generation time but can 
be changed by the ALLOC command. 



Note: The begin and end address fields for a partition that is not allocated contain the begin and end addresses of the following partition. 
Figure 4.45. Explanation of the contents of the Boundary Box 
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PAGE MANAGEMENT Converting virtual to real addresses and vice-versa 

TABLES 

There are several methods of calculating real addresses from virtual and vice versa. 

One method is given below. 

(The values assumed in the examples apply to the illustration opposite.) 

A. Converting a virtual address to real: 

1. Write the hexadecimal virtual address in binary. For example (assuming 
a virtual address of 1FA20), 

^^1 F A20 -~-_____^^ 

0001 1111 1010 0010 0000 

2. Ignore the ten rightmost bits. For the example, this leaves 

0001 1111 10 

3. If after step 2 the rightmost bit is a 1 , change it to a 0; if it is a 0, 
leave it 0. 

4. Convert the binary value obtained in step 3 to hexadecimal. 
For example, 

0001 1111 10 

— I f— 

7 E 

5. Locate the address of the page table, contained in the first entry of 
the segment table, the address of which is contained in CRl. (For 
example shown opposite, this is 6A28,) 

6. Add the address of the page table to the hexadecimal number obtain'ed 
in step 4. 

For example, 

6A28 

^ _ZE 

= 6AA6 (This is the address of the entry in the page 
table associated with the virtual address to be 
converted to real. ) 

7. Locate the page table entry in the dump. 

8. Replace the right most bit of the contents of the page table entry 
by a 0. 

For example, as shown in the illustration opposite, the page table 
at address 6AA6 contains 01B9. The right most bit is a 1 (X'9' = 
1001.) 

9. After replacing the right most bit by a 0, convert the resulting four-bit 
binary string to hexadecimal. 

For the example, 1000 - X'S'. 

The value thus obtained in this example is IBS. 

10. Increase the value obtained in step 9 by attaching two Os to the right. 

For example, 01B800 (This number is the address in real storage 

of the lower limit of the page frame in which 
the real address is located.) 

1 1 . Convert the eleven rightmost bits of the binary value obtained in step 1 
to hexadecimal. 

For example, 

010 0010 0000 

-I 1 — — f— 

2 2 

12. Add the value obtained in step 1 1 to the number obtained in step 10. 

For example, 

01B800 

01BA20 (This is the real address.) 
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Bytes X'D0-D3' of SYSCOM 

and 

Control register 1 

contain the address 
of the segment table. 



00006C80 






o 



FO 00 6A 28 
6A 68 



6A_A8 
6A E8 
6B 28 
6B 68 
6B A8 
6B E8 
60 28 



Segment table 
Each entry 
represents 
64K (dec) 
of virtual 
storage. 



Page table 

Each entry represents '^®^' ^'^^''^ss area 

2048 (dec) bytes of 'f the invalid-bit of the 

virtual storage. There page table entry is 

are 32 entries in set (=1 ), the page 

the page table for each resides in the real address 

entry in the segment area. 

table 



0000 



0008 
0010 



0000 00 



00 08 00 



00 10 00 



01 BO 00 



01 B8 00 



01 CO 00 



3F 00 00 



3F7F FF 



Page frame table 

Each entry represents 2048 (dec) 
bytes of the real address area, and 
indicates the status of the 
attached page. 



PAGE MANAGEMENT 
TABLES 















// 




// 

/ 

/ 

/ 
/ 

/ 




Y=^^ 




00 3F 




=^==j 



Page frames 
allocated to 
the supervisor 



J 



Page frames 
allocated to 
(' partitions running 
in real mode 



Page frames 
^ allocated to 
the page pool 



End of real storage 



Explanation of the illustration. 

The segment table in this example starts at address 6C80. 

The page table starts at address 6A28. 

Three valid entries in the page table are shown allocated to three consecutive 

2K slots in the real address area. (The associated entries in the page frame 

table are indicated.) 

The page entry at address 6AA6 contains a value of 01B9 which is used in the 

example given on the opposite page. 

Figure 4.46 illustrates the relationship between the page management 
tables that are described in this chapter. 



Debugging for Programmers, part 2. 4.117 



Section 4, Chapter 12 

PAGE MANAGEMENT Converting a real address to virtual: 

TAR I E*^ 
/-\D L-to J Write the hexadecimal real address in binary. For example, 

/01BA20c 
I. ^ 



0000 0001 1011 1010 0010 0000 

2. Ignore the eleven rightmost bits. Thus, for the example, 

0000 0001 1011 1 is the remaining binary number. 

3. Add three Os to the right of the binary number obtained in step 2. 

Thus 

0000 0001 1011 1000 

4. Convert this binary value to hexadecimal. 

For example, 

0000 0001 1011 1000 

n r "1~ "T- 

1 B 8 

5. Add the number obtained in step 4 to the address of the page frame 
table. Bytes X'D4' - X'D7' of SYSCOM contain the address of the 
page frame table. (For the example, this is assumed to be 6100.) 

For example, 

6100 
"^ 188 

= 62 B8 

6. Locate this address in the dump. (This is the address of the page frame 
table entry associated with the real address to be converted.) 

7. Locate bytes 4 and 5 of this page frame table entry. (For the example, 

as illustrated in Figure 4.46, a value of 003 F is assumed.) jf j 

8. Write this hexadecimal number in binary. 

Thus for the example, 

0000 0000 0011 1111 

9. Ignore the leftmost three bits, and add three Os to the right hand end 
of the resulting binary string. 

Thus, 

0000 0001 1111 1000 

— T -T— — r — r 

1 F 8 

1 1 . Convert the eleven rightmost bits of the real address (as written in 
binary in step 1) to hexadecimal. 
For example, 

010 0010 0000 



2 2 

12. Add the number obtained in step 10 to the number obtained in step 1 1 
For example, 

01F800 
■*" 220 



01 FA20 (This is the virtual address.) 
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EVENT PGM CHK INTERRUPT TOO MICSEC 



GPR 0-7 
GPR 8-F 
CTl 0-7 
CTL 8-F 
LOW CORE 
00000000 
00000020 
00000040 
Q000C060 
00000080 
OOOOOOAO 
OOOOOOCO 



OOOOOOIB 00040910 00000021 
00000000 00000000 00000000 
00'VOOOFFfOOOOE640)FFFFFFFF 

tiU^ OCOOOO 

^*^ 020007 
00000000 20000060 
00000000\00000000 00000000 
-SAME 



2333009458490780 PSM AT TIME OF EVENT 471D300000< [4071 §) INSTR DE03C676C5EC 
00000003 0000002E 00000000 00000000 OOOOOOOO 
^nninn-TA n/^n/. im. "■»'-,8ClE2 A00406EE 000422AO 



)00000 OOOOOOOO OOOOOOOO 



OOOOOOOO 
47100000 
10O0E7F0 
44 DC 00 00 
LOO0O0S4 
0000000 



fio^eMM «■/ iXZ )ooooo C2000000 00000200 
active coMAe<r 



)C (04AQ) 40000000 OOOOOOOO 

J3E974 470C2000 OOOO09OC 

F256BC00 01AAAB17 440C00O0 OO0O0C14 

04080000 000OD13A 440C0OO0 00000810 

12042003 00020000 OOOOOOOO OOOOOICC 

OOOOOOOO 00000100 OOOOOOCE OOOOOOOO 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



SUPERVISOR 

000001 2O^/l50OOOCO0 



SV5C0M 



000004AO 
000004C0 
000004EO 
00000500 
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Figure 4.47. An example of an SDAID "dump on program check" showing how 
to locate the page management tables. 
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Channel program translation 

This chapter describes the control blocks used by the DOS/VS channel program 
translation routines, which may require examination under certain circumstances 
of a system malfunction. 



I/O operations and of virtual storage 

For a full description of the channel program translation routine, refer to the 
DOS/ VS Supervisor Logic manu al . 



General functions 

Because the DAT (dynamic address translation) feature is not available for data 
and channel command words of I/O operations, software routines are required that 
perform the following functions for an I/O request from a virtual partition: 

1 . The CCB and, if applicable, the user sense CCW will be copied into a buffer. This 
buffer is called the CCB copy block and is maintained by the CCW-translation 
buffer management. 

If a second I/O operation from a virtual partition is requested, the copied and 
translated CCB is queued behind the first request in the CCB copy block queue. 
Label ACCBB in the supervisor listing points to the address of the CCB copy 
block queue. Displacement X'44' from this address contains the address of the 
second CCB copy block. 

2. The complete channel program, consisting of one or more CCWs, will be copied 
into a buffer area called the CCW copy block. The copied channel program is 
logically equivalent to the original channel program, the data addresses being 
translated to real addresses. The copy process conserves the channel program 
structure, but TIC (transfer in channel) commands will be inserted in the copied 
channel program when there are more than seven CCWs in a channel program. 
Figure 4.51 shows a channel program having eleven CCWs; two copy blocks that 
are linked by a TIC command are therefore required. Figure 4.52 illustrates the 
format and contents of the CCW/TCB. 

3. Addresses in the copied channel program that refer to an I/O area in a virtual 
partition are translated into the corresponding real addresses. If the I/O area is 
completed on one page, the real address will replace the virtual address in the 
copied channel program. If the I/O area occupies more than one page (crosses 
page boundaries), an IDAL (Indirect Data Address List) block is built up. The 
IDAL block contains the real address of the I/O area and the real page addresses 
of any pages occupied by the I/O area. The address of the IDAL will replace 
the virtual address in the copied CCW, and the IDAL bit (bit 37 in the CCW) 
will be set to 1 . If the virtual channel program already uses the IDA feature, 
both the IDAL from the virtual partition copied and the virtual addresses will be 
replaced by the corresponding real addresses. 

Figure 4.48 illustrates the actions described in points 1, 2 and 3 above, and 
Figure 4.49 illustrates the relationship between the blocks described. 
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User-task 



EXCP 



Via dispatcher 



user-task 






Under PI K of usertask 
that requested I/O 



Via dispatcher 



• Move parts of copied CCB 
to original CCB 

• Release buffer of copied CCB 

• Reset indicator for moved 
CCB 



• Copy CCB 

• Copy CCWs 

• Translate copied CCB 

• Fix data areas 

• Build IDALS (if required) 

• Translate copied CCWs 

• Enqueue request to channel 
queue 

• Start I/O 



l/0-interrupt handier 



l/0-interrupt belonging to above 
mentioned l/0-request 

• (handle ERP) 

• Transfer interrupt information 
from CSW to copied CCB 

• Post CCB, post task dequeue 

• Request from channel queue 

• Retranslate CCW- address in 
copied CCB to virtual free 
data areas 

• Release copy buffers, except 
that of CCB 

• Set indicator and move CCB 
if necessary 



Under PI K of interrupted task 



o 



Figure 4.48. Illustrates the activity between user program and supervisor during 
the handling of an I/O request from a program running in virtual 
mode. 



Debugging for Programmers, part 2. 4.121 



Section 4, Chapter 13 

CHANNEL PROGRAM 
TRANSLATION 



Additional functions performed by the channel program translation routine are: 

4. A sense CCB (if applicable) is updated in the copied CCB. 

5. All I/O areas required by the channel program must remain in real storage until 
the I/O operation is complete. For this reason all pages involved v^^ith an I/O 
operation are fixed in real storage. 

After the above functions have been performed, the I/O request is handled as if it 
were a request from a real partition. The following supervisor activity then ensues.- 

1 . The request is placed in the channel queue. 

2. A START I/O is issued. 

3. The corresponding interrupts are processed. 

4. The ERPs are activated (error recovery procedures in case of I/O device errors). 

5. Status information is posted in the copied CCB. 

6. The request is removed from the channel queue. 

After completion of an I/O request from a virtual partition, the channel program 
translation routine translates the real command address (from the CSW) to the 
corresponding virtual address, frees all fixed pages that were required by the 
request, transfer parts of the copied CCB to the virtual CCB, and releases all areas 
used by the buffers required by the channel program translation routine. 

Figure 4.48 illustrates the complete operation described above under points 1 
through 5. 



IDAL block 

The IDAL block is generated by the CCW translation routine if the I/O area 
specified in a CCW crosses page boundaries. The IDAL blocks are placed in the 
buffer area at the end of the supervisor together with associated CCB and CCW 
copy blocks. Each block contains real addresses of the data areas in real storage. 
Because each address is 4 bytes in length, an IDAL block can contain up to 1 8 
addresses (also referred to as IDA words.) Each IDAL must be completely 
contained in one IDAL copy block. If more than one I/O request requires an IDAL, 
as many IDALs are placed in one IDAL copy block as will fit. 

The figure opposite shows the relationships between the blocks. 

Appendix G shows an example of locating a CCB copy block and CCW copy 
block in a stand-alone dump output. The CCB address in the channel queue is used 
as the initial pointer. 
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CCB copy block 

CCB copy blocks are placed in a buffer area (specifically reserved for the channel 
program translation routine) at the end of the supervisor together with the 
associated CCW copy blocks and IDAL block (if required). Each CCW copy block 
consists of nine entries. The first seven entries are used to store copied CCWs, and 
the remaining two entries (16 bytes) contain pointers and end-of-buffer indicators. 
The format and contents of a CCW copy block is shown in Figure 4.50. 
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Figure 4.49. Illustrates the relationship between an original channel program in a 
virtual partition and the copy blocks required by the channel program 
translation routines. The input/output areas in real storage are also 
shown. 
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Field 



Legend: Square keys 
refer to the description 
below. 








1 


2 


3 


4 


5 


6 


7 





CCBCNT 


CCB 
C0M1 


CCB 

COM2 


CCB 
STA1 


CCB 
STA2 


CCB 
CLS * 


CCB 

LNO 


8 


CCBCCW 

Address of first CCW 


CCBBY3 


CCBCSWW 


16 


CCBSENS 
Sense CCW if any 


24 


CCBPIK 
User PI K 


CCB 
FLAG ** 


Unused 


CCBVA 

Virtual Address of CCB 


32 


CCBACB 

Address of first CCW copy block in 

channel program 


CCBICB 

Address of first IDAL block in channel 

program 


40 


CCBXINF 


(Fix information; 24 bytes) 

Each bit in this field represents one page frame. 
If a bit is on, the associated page frame contains 
a page fixed for this I/O request. If more than 
384K of real storage are available, the address 
in CCBXPTR will point to any additional field 
which contains bits for the page frames beyond 384K. 




48 






56 






64 


CCBXPTR 

Address of additional Fix information 


CCBNEXT 

Address of next CCB copy block 



Set to X'21' {= copied CCB) 



Legend CCB FLAG: Bit 


1= Translation complete 


1 


1= Pages fixed 


2 


Not used 


3 


1= BTAM Second Time Request (I/O request from 




BTAM appendage) 


4 


Not used 


5 


Not used 


6 


Not used 



Description 



(16 bytes): Copied and updated CCB. 

(8 bytes): If a user sense CCW is available, the CCW will be copied into this area. If the sense I/O area crosses a page 
boundary, an IDAL will be generated and the address of the IDAL will replace the address jn Sense CCW. 

(2 bytes): Contains the PIK-value of the virtual I/O requestor. This value will be used by the MOVECCB routine to 
identify the requestors CCBs. 

(4 bytes): Contains the virtual address of the original CCB. 

(4 bytes): Address of the first CCW copy block occupied by the real channel program. 

(4 bytes): Address of the first IDAL block of zero, if no IDAL is needed. 

(24 bytes = 128 bits): Contains the fix information for the I/O request (FIXINF). Each bit corresponds to a physical 
page frame. If a bit is one, the corresponding page is fixed for the current I/O request. The 128 bits are sufficient for 
a Relocate System with up to 384 K bytes of real storage. 

(4 bytes): If real storage is greater than 384 K, the FIXINF is logically continued in another copy block with 68 usable 
bytes corresponding to 1032K additional real memory. The address in H will point to the attached fix information 
field. For real storage not greater than 384K, the value of H will be zero. 

(4 bytes): Contains a chain pointer. All CCB copy blocks will be enqueued into a CCB Copy queue. CHAINPTR 
points to the next CCB copy block on the queue. If this copy block is the last one, CHAINPTR equals zero. The 
pointer ACCBB either will point to the first CCB copy block on this queue or is zero, if no CCB is copied. 



4.123 Figure 4.50. Explanation of the contents of a CCB copy block. 
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Channel Program without TIC or SEARCH Commands 

The CCWs in a channel program without TIC or SEARCH commands are copied 
into sequential locations in the CCW copy buffer. If the program has more than 
seven CCWs, a TIC is inserted in the eighth copying position and is made to point 
to the first CCW in the next copy buffer. CCWs 8 through 14 are then copied in 
the next copy buffer. If there are more than 14 CCWs, the process is repeated 
until all CCWs are copied. 

Refer to the DOS/VS Supervisor Logic manual for a full description of the CCW 
copy block when using TIC and SEARCH commands. 

Figure 4.51 (below) shows the copying of CCWs for a channel program requiring 
two CCW copy buffers. 
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VIRTUAL STORAGE 



REAL STORAGE 



o 



Virtual Channel Program 



CCBNAME CCB SYSxxx, CCW1 



Copied CCB (See Figure 4.50). 



CCW1 


CCW 


CCW2 


CCW 


CCWS 


CCW 


CCW4 


CCW 


CCW5 


CCW 


CCW6 


CCW 


CCW7 


CCW 


CCWS 


CCW 


CCW9 


CCW 


CCW10 


CCW 


CCW11 


CCW 




CCW Copy Block 1 
(See Figure 4.52) 



CCW Copy Block 2 
(See Figure 4.52) 



Legend: TIC 



Transfer in channel command 



ACCW8 = Address of CCWS 
ANB = Address of next CCW Copy Block 
VB A = Virtual Address of CCW 1 (for Copy Block 1 ) and virtual 
address of CCWS (for Copy Block 2). 



o 



Figure 4.51. A channel program requiring a TIC to be inserted in copying. 
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16 
24 
32 
40 
48 

56 
64 



\--J' 



1st Copy location for CCW 



2nd Copy location for CCW 



3rd Copy location for CCW 



4th Copy location for CCW 



5th Copy location for CCW 



6th Copy location for CCW 



7th Copy location for CCW 



X'80'^ 



X'88'*^ 



X'OOOOOO' 



X'OOOOOO' 



Virtual address of first CCW in the 
Copy block 



Address of next CCW Copy block in 
the chain 



* X'80' indicates the end of the CCW copy locations in the block. It is replaced by a TIC 
(Transfer in Channel command) if the 7th copy location contains a copied CCW with data- 
or command chaining. Bytes 57-59 will then point to the copy location of the CCW 
following the CCW in the 7th copy location. 
Bytes 56-59 will not be changed if the CCW in the 7th copy location is a TIC. 

** X'88' indicates the last 8-byte entry in the block. It is replaced by a TIC if the CCW in the 
7th copy location is a status modifier CCW. For example a SEARCH command to a disk. 
Bytes 65-67 will then point to the copy location of the second CCW following the status 
modifier CCW. 

Figure 4.52. Format and contents of a CCW copy block 
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Translation Control Block 

The routine CCWTRANS is called by the channel scheduler whenever a channel 
program must be copied and translated. Since a page fault may occur during 
CCWTRANS, the routine and its subroutines are reenterable and can therefore 
process several translation requests concurrently. In order to make CCWTRANS 
reenterable a translation control block (TCB) is built for each task to serve as a 
dynamic work and save area. Each TCB is located behind the special save area for 
its task and has the format shown in Figure 4.53. 

How to locate: 

To locate the TCB (associated with the partition/task), add X'50' to the address of 
the System Save Area (displacement X'09' of the appropriate PIB). Labels 
CCWTCBl - CCWTCBn identify the first byte of the appropriate TCB. 



Format 
of any TCB 

1 



3 4 



11 



12 15 



16 



19 20 



23 24 



27 



Flag 

byte 

* 


used 

by 

BTAM 


TIK/PIK 


Pointer to 
Status Modifier 
List 


Pointer to 
Control Com'd 
List 


Pointer to 
TIC line 


Pointer to 
Copy Block 
End 


Address of 
copied CCB 
(for cancel) 


Number of 
free IDA words 
in IDAL block 



28 



47 48 



51 



52 



107 108 



111 



Work Areas 


Address of 
last TF IX 
request 


Save Area 
(Registers 2-F) 


Pointer to 
next used 
TCB 



\J) 



* Byte 0: bit = 1 : data chaining specified 

1=1: Read/Sense command specified 

2 = 1: Read backward command specified 

3 = 1: Status modifier command with data chaining 

4 = 1: Status modifier command only 

5 : Reserved 

6 : Reserved 

7 : Reserved 

Note: One TCB is generated for each partition supported. 

With asynchronous processing support, 15 TCBs are generated. 



Figure 4.53. Explanation of the contents of the TCB. 
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Fix Information Blocks 

In order to keep track of which page frames have been TFIXed for a request, a bit 
string is used which has a bit for at least every page frame up to the highest one 
which is TFIXed. If no page is TFIXed in an address higher than 384K, then the bit 
string in CCBXINF is sufficient (192 bits = 384K). Whenever a page is TFIXed, the 
bit corresponding to its page frame is set to one. If a page is used more than once 
by a request, it is TFIXed only once. 

If a page is TFIXed at a location beyond 384K, one or more additional bit strings 
must be added. This is done by enqueuing a copy block. Each copy block thus 
enqueued provides fix information for an additional 1088K of real storage. The 
additional blocks are queued with the first one being pointed to by the field 
CCBXPTR in the CCB copy block. Figure 4.54 shows how fix information is kept. 



v._y 



Fix-String: 

bit-table where each bit belongs 
unequivocally to a page franne 
(for 1038K bytes); if a bit is on, 
the page frame belonging to this 
bit has been TFIXed for this 
l/0-request. 

ANB: 

—0 if Fix-block is last one in 

Fix-block queue. 

—address of next Fix-block. 



Fix-string 
of 544 bits 



+68 ANB 



Fix-bit string- 
represented — 
page frame 



1 



■CCBXINF- 



OK 



TFix(l) 



Fix-string 1- 



384 K 



Fix-string 2- 



TFIX (2) 
384 K 
+1088K 



384 K 
+ 1088K 
+1088K 



• if for a specific page franne ttie Fix-bit is already on, noTFIX-request is transferred to the 
.page manager 

• the TFIX-b/ocl<s are freed after l/O-request has been posted complete 
F igure 4.54 Fix information Bit String and Block 
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General Rules for channel program translation 

The following rules apply to IBM -supplied channel program translation routine 

1. Channel program translation is skipped: 

• for I/O requests from programs running in real mode 

• for I/O requests from system tasks (FETCH/LOAD has its own small CCW- 
translation.) 

• for I/O requests for console when console buffering option is supported 

2. Channel program translation is modified for BTAM running in virtual mode 
(modify CCW-chain from I/O appendages). 

3. The following components work via copied and translated CCW chains: 

• CRT 

• seek separation routine 

• ERPs 

• BTAM-ERPs 

4. Channel program translation does not support: 

• self-modifying channel programs 

• start of I/O requests from I/O appendages for not translated channel programs 
(except BTAM) 

• time dependent I/O requests (channel program may get longer after translation) 

• channel programs with CCWs whose count is 32K 

• channel programs with data chaining in connection with TIC-commands when 
the same CCW gets different command codes during execution of channel 
program. 
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PD AREA TABLES 





Byte 



4 

8 

12 

16 

20 

24 

28 

32 

36 






PDAREA 


PDAREAND 






PDINTRHK 






PDSIQHK 






PDTRANHK 






PDFLTHK1 






PDFLTHK2 










PDREGSAV 















Address of end of PD area 
Address of interrupt trace hook* 
Address of START I/O hook* 
Address of transient dump hook* 
Address of F/L trace hook 1 * 
Address of F/L trace hook 2* 
Reserved 

Save area for registers 9, 10, and 1 1 



*A hook is coding introduced at supervisor generation. The coding normally branches around 
itself. The initialization makes the branch instruction a NOP to allow a PDAID function to be 
performed. 

Figure A.l. The PD address table (Displacements are in decimal) 

Byte 






16 



24 



32 
40 
48 



Phase Name 



VER 



MCD 



IGN2/TRC2 
CUU 



Alternate 



Area 



Log 
,CUU 



IGN3/TRC3 
CUU 



End 



PRT1 



PRT2 



PRT4 



PRT5 



\ 

Alternate Area Start 



1 

CHANC PTR 



1 

Reserved 



Reserved 



Reserved 



OPT 



1 

Register I© 



Displacement 


Label 


Description 


0-7 


Phase Name 


Phase being run 




8 


VER 


Version number in hex 




9 


MOD 


Modification level in hex 




10-11 


LOG 


Address of system log device 




12-13 


Output 


Address of output device 




14-15 


IGN1/TRC1 






16-17 


IGN2/TRC2 


Address(es) of devices to ignore or trace 




18-19 


IGN3/TRC3 






20-23 


Alternate 
Area Start 


Start address of alternate area 




24-27 


Alternate 
Area End 


Ending address of alternate area 




28-31 


CHANG PTR 


Address of channel queue pointer for output 
device 




32 


PTR1 






33 


PTR2 






34 


PTR3 


Partitions to be ignored (see note) 




35 


PTR4 






36 


PTR 5 






37-50 


Reserved 






51 


OPT 


Option byte X'OO' = TRC device 
X'80'= IGN device 




52-55 


Register 10 


Save area for register 10 (used by GSVC trace on 


ly) 



Note: The initializer inverts the logic. When the user specifies a partition(s) to be traced, PDAID 
enters the partition (s) to be ignored in the standard preface table. 

Figure A, 2. The PD Standard Preface Table (Displacements are in decimal) 
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PIK (Partition Identification Key) 

During debugging, it may be necessary to locate and to be able to interpret the PIK 
value allocated to each partition. 

The PIK of each partition is determined during system generation the PIK value 
being contained in a two byte field at displacement address X'2E' in the appropriate 
partition communication region. Byte of this location always contains X'OO', 
and byte 1 a hex number equal to the displacement from the start of the PIB to 
the start of the entry in the PIB belonging to the partition. 
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PIK, SYSLOG ID 
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Foreground partition PIK 

The PIK value for foreground partitions depends on how many partitions are 
specified by NP ARTS parameter of SUPVR macro. 



PI K value at displapement address X'2E' of foreground COMR EGs, 
where byte = X'OO' and byte 1= ; 


NPARTS=5 


NPARTS=4 


NPARTS=3 


NPARTS=2 


PIK value indicated 


50 
40 
30 
20 


40 
30 
20 


30 
20 


20 


F1 
F2 
F3 
F4 



Note: The PIK values for foreground partitions do not change during system 
operation. 

Figure B.l. PIK Values 

Background partition PIK 

The PIK value for the BG partition is always X'lO'. However, unlike the values in 
the foreground communication regions, the value held in this address changes during 
system operation. It always contains the PIK value of the active partition. 

Supervisor PIK 

A separate PIK value is given to the attention routine. The value is X'OO', and 
indicates that the supervisor is in control. 



SYSLOG ID 

For PD output, values will be AR, BG, F4, F3, F2, or Fl , which identify the 
partition generating the trace entry. 



o 
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TIK, LIK 



TIK (Task Interrupt Key) 

The halfword TIK at displacement X'5 A' in the SCP Communications Region 
(SYSCOM) has a zero value in the high-order byte and a key value in the low-order 
byte. This key value is only significant when AP is supported. The key value in 
the TIK is the key of the program (task or subtask) that is being serviced. When an 
interruption occurs, the value of the TIK indicates to the supervisor which program 
(task or subtask) was interrupted. 

The TIK is set by Task Selection in the General Exit Routine and equals the index 
displacement of the task's Program Information Block (PIB) within the PIB Table. 

Depending on the number of partitions supported, the value of the TIK indicates 
which task was interrupted according to the following table: 



TIK Value 


Interrupted 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


Task 


X'OO' 
X'10' 

X'20' 

X'30'- 

X'FO' 


X'OO' 
X'10' 

X'20' 

X'30' 

X'40' - 

X'FO' 


X'OO' 
X'10' 

X'20' 
X'30' 
X'40' 
X'50' - 
X'FO' 


X'OO' 
X'10' 
X'20' 
X'30' 
X'40' 
X'50' 
X'60' - 
X'FO' 


Attention 
BG 
F4 
F3 
F2 
F1 

Subtasks* 



*Asynchronous Processing option. The number of PIBs initially available for subtasks is 10, 1 1 , 
12, or 13, depending on the number of partitions (in an AP supervisor the total number of 
PIBs is always sixteen). 



LIK (Logical Transient Owner Identification Key) 

The halfword LIK at displacement 88 in the SCP Communications Region (SYSCOM) ^_^^ 
is only significant if AP is supported and contains the same value as the TIK when ijf j 

the logical Transient Area (LTA) is in use. LIK therefore, identifies the owner of \_7 

the LTA. When the LTA is free, the halfword LIK contains zeros. The SVC 2 
routine sets the LIK, and the SVC 1 1 routine resets it to zero. If AP is not supported 
the LIK contains zeros. 
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LTK (Logical Transient Key) 

The halfword LTK at displacement X'6E' in each partition's communications region 
has a zero value in the high-order byte and a key value in the low -order byte. 

In a foreground communications region, the key value in the LTK is not significant. 
The LTK in the background communications region (BGCOMREG) has the same 
value as the PIK of the partition of the task that owns the LTA, or contains zeros 
when the LTA is free. When the LTA is occupied by a task, therefore, the 
BGCOMREG has the same value in its LTK as in its PIK when the owning task is 
active. The SVC 2 routine sets the LTK, and the SVC 1 1 routine resets it to zero. 
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REQID (I/O Requestor's Partition or System Task ID) 

The REQID is one-byte identifier in the Channel Queue (CHANQ) entry. 

When a background or foreground program has requested I/O, the REQID has the 
same value as the key byte of the PIK for that task's partition. When the Attention 
Task has requested I/O, the REQID contains X'OO'. 

When the request for I/O is from a System Task, the REQID has one of the 
following values: 

RAS -x'or 

PMGR -X'02' 
SUPVR -X'03' 
CRT - X'04' 
ERP - X'05' 
PAGEIN-X'06' 

The REQID is set by the Channel Scheduler Routine. 
Note that X'OO' indicates that no system task is active. 
TKREQID (I/O Requestor's Task Identification) 

The TKREQID is a one-byte identifier in the Channel Queue (CHANQ) entry for 
a task that has requested I/O (see Figure 4.1 3). In an unused CHANQ entry the 
TKREQID contains X'FF'. 

The TKREQID byte in an active CHANQ entry has the same value as the key byte 
of the TIK of the task that has requested I/O. 

If AP is not supported it has the same value as the PIK of the task that requested 
the I/O. 

TKREQID is set by the Channel Scheduler Routine and reset by the I/O 
Interrupt Handler. 
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Appendix C 

CONTROL REGISTER 
ALLOCATION 



Control 
Register 



10 



11 



12 



13 



14 



15 



SYSTEM CONTROL 


TRANSL. CONTROL 


EXTERNAL-INTERRUPTION MASKS 


SEGM-TBL LENGTH 


SEGMENT-TABLE-ORIGIN ADDRESS 




CHANNEL MASKS 














MONITOR MASKS 


PER EVENT MASKS 




PER GR ALTERATION MASKS 




PER STARTING ADDRESS 




PER ENDING ADDRESS 






ERROR-RECOVERY CONTROL & MASKS 






MCEL ADDRESS 



J 



Figure C.l. 
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The following two examples show the two different features of the ESERV program: 
that of de-editing without updating an edited macro definition, and that of de-editing 
and updating an edited macro definition. 

Sample Coding for De-editing without Updating a Macro Definition 



ESERV EXAMPLE 
JOB STREAMS 



//JOBNOUPDATE 
//EXEC ESERV 
PUNCH E.MAC1,MAC2 
/* 
/& 



(See note 1) 
(See note 2) 
(See note 3) 



Notes: 

1. Name of job is NO UPDA TE. 

2. Causes ESER V to de-edit the macro specified in the following PUNCH 
statement. 

3. Causes the macros MA CI and MAC2 to be punched out from the macro 
library (E) 

You could use the above coding to produce a de-edited source macro for possible 
future updates. 

Sample Coding for De-editing and Updating a Macro Definition 

The Procedure iii the following exarnple produces a de-edited, updated macro 
definition in source format, and edits and places the update macro definition in 
the macro library, using the MAINT program. 






//JOB UPDATE 
// EXEC ESERV 

GENEND 



DSPCH E.MAC1 



) COL 77,4 
) VER 72+1,5 

.PP9 

) ADD 72+1 

AIF (&PCH NE 1400) D4 
) DEL 102,103 
) REP 245 

JOYCE CLC (4,REGG) ,BLANKS 
) END 
/* 

// PAUSE 

//OPTION EDECK,NODECK 
//EXEC ASSEMBLY 

(deck produced by ESERV 
goes here) 
/* 

// PAUSE 
//EXEC MAINT 

(deck produced by 
assembler goes here) 
/& 



Causes ESERV to de-edit the macro 
specified in the following DSPCH statement. 
Causes an END and /* statement to be 
generated. These are necessary to allow 
output from ESERV to be used immediately 
as input to assembler program. 
Causes the macro definition MACl to be 
punched and printed from the macro 
Hbrary (E). 

For explanation see: "Verifying/ 
Updating Statements from a Printout 
of Macro Definition". 



Check list, move deck to reader. 
Causes the assembler to produce an edited 
deck (EDECK): no object module 
will be produced (NODECK). 



Move SYSPCH deck to reader. 
Causes MAINT to put edited macro 
definition on macro library. 
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Appendix E 

PROGRAM EVENT 
RECORDING 



The purpose of the program-event -recording faciUty is to assist in debugging 
programs, for example, SDAIDS. It permits the program to monitor the following 
events: 

• Successful execution of a branch instruction within the 
designated virtual storage limit 

• Alteration of the contents of designated general registers 

• Fetching of an instruction from designated storage locations 

• Alteration of the contents of designated storage locations 



■<f~\: 



The information for controlling program-event -recording resides in control 
registers 9, 10, and 1 1 , and consists of the following fields: 



Control register 9: 






EVENT M. 




GR ALTERATION 


M. 


8 16 
Control register 10 (X'A'): 


31 




STARTING ADDRESS 


8 
Control register 1 1 (X'B'): 


31 




ENDING ADDRESS 



8 31 

PER Event Mask: Bits 0-7 of control register 9 specify which events are monitored. 

The bits are assigned as follows: 

Bit 0: Successful Branching 

Bit 1 : Instruction Fetching 

Bit 2: Storage Alteration 

Bit 3: General-Register Alteration 

Bit 4: Unassigned 

Bit 5: Unassigned 

Bit 6: Unassigned 

Bit 7: Unassigned 

Bits 0-3, when ones, specify that the corresponding events are monitored. When a 

bit is zero, the event is not monitored. 



%. 
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Appendix E 

The monitor call instruction provides the capability for passing control to a MONITOR CALL 

monitoring program such as the IBM supplied SDAID trace routines, when selected 
indicators are reached in the monitored program. The indicators are MONITOR CALL 
instructions implanted in the monitored program. When executed, these instructions 
cause a program interruption for monitoring to take place, provided that an inter- 
ruption is allowed for the monitor class specified by the instruction. Along with the 
interruption, the monitor class number and a monitor code are stored for subsequent 
use by the monitoring program. 

The instruction MONITOR CALL designates one of 16 monitoring classes together 
with a set of 16 monitor masks in a control register. One mask bit is associated 
with each class. The execution of the instruction causes a program interruption 
when the monitor-mask bit for the class specified in the instruction is one. The 
cause of the interruption is identified by setting bit 9 of the interruption code to 
one, and by the information placed at locations 148-149 and 156-159 of low 
address storage. 

The monitor-mask bits are in bit positions 16-31 of control register 8. 





MONITOR MASKS 



16 31 

The mask bits, in ascending order of bit positions, correspond to monitor classes 
0-15. Any number of monitor-mask bits may be on at any time; together they 
specify the classes of monitor events that are monitored at that time. The mask 
bits are initialized to zero. 
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LINE MODE TABLE 



This table is built at supervisor generation time when the TP=BTAM, or QTAM 
parameter is included in the SUPVR macro, and M0DEL=1 1 5 or 125 . An entry 
is built for each device for which the DVGEN macro includes the MODE=X'ssss' 
or X'ssssss' parameter. Each entry contains the actual mode setting for the device. 



MODTAB 



Number 

of 

start /stop 

lines 



Maximum 



Number 
of 

BSC 
lines 



Maximum 







1 



Actual S 



Actual ■< 



jH 



The first 4 bytes of the table 

Maximum number of start/stop lines. Sej: by the IOTAS 
macro at system generation 

Maximum number of BSC lines. Set by the lOTAB macro 
at system generation 

Actual number of start/stop lines. Determined by DVCGEN 
macros at system generation and ADD commands at IPL 



r\ at 



Actual number of BSC lines. Determined by DVCGEN macro 
system generation and ADD commands at IPL 



not used 



Line Mode settings for 
Models 11 5 and 125 Comm. Adapter 



,4"^, 
'i_>' 



^r~ 



V 



.-../ 



Bytes 140-143 (X'8C'-X'8F') of the System Communication Region (SYSCOM) 
contain the address of the table. 

Label MODTAB identifies the first byte of the table 



Figure F. 1 . Line Mode Table (LMT) 



c 
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This appendix shows an example of the output obtained from a formatted stand- 
alone dump as generated by the IBM program DUMPGEN with the parameters 
FORMAT=YES and PPOOL=NO. 

Refer to Section 2-A-3 for a description of DUMPGEN and the stand-alone dump 
program. 

In a system dump output, the supervisor area dumped is almost identical to that 
dumped by the formatted stand-alone dump, the only difference being that a 
system dump does not divide the dump into blocks of 2K storage areas. Refer 
to Section 2-A-2 for a description of the system dump. 

The programmer's remarks on the dump example indicate how the various tables 
and information blocks are located by using addresses stored in the communication 
regions. The programmer has also indicated the meaning of several bytes on the 
dump, enabling a mental picture to be built up of the system status just before 
the dump program was executed. 

Following the last but one 2K block of real storage (246 in the example shown), 
the page status information and contents of the control registers is printed. In 
the example shown of a formatted dump, the control registers are followed by the 
communication regions. (This does not include the system communication region.) 

The remaining part of the example shows the order and format of the tables and 
information blocks printed in a formatted dump output. 

The last block to be printed is the SELECTION POOL, the contents of which are 
explained in a note at the end of the example. 

IMPORTANT NOTE 

The location and addresses of the table and information blocks shown in this 
example apply only to the system that produced this example. The actual location 
of areas indicated depends on the system generation options specified, and the 
program running in your system just before the dump program is executed. 
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DUMP OUTPUT 
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Figured part 1 of 20 
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EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



HllliillillliliilililHHI 



F?A''^r.hl'> iJbC.iF^CS 36')5'tOL)5 .)6C 3^.00'; ETCSCBt-i t}C5CA(,iJ '.0C3D9AO C<»r)540C9 

O^CJFJCq C1034nF-2 tJCleje^ E^ClC^Ci DqCbL2t? Ci>J?^~C6 DAD'J'.Ob? f.5C70'.C5 

:J5f-;?40El ClC2l)3t5 <.0C9:15',(, C3D9ri<,0 C1USC440 h2F'U2C3 OftD'i'fOC'i C)S4C0506 

E3*004C1 C3C^CRC3 J9F 1*0C 3 ;"36L)it»Ct) 05E 3E2^0 C9E2^r!t;3 C1l)2C5D5 AHfjOb'^O 

03i)6C3Cl e?lC'><.nE3 aC^'iOf.?. CSCn'fCb 05t3A0E3 C1C2D3CS C9|-)lC2t2 C5C7F3'>0 

C3JftJ5E3 C5t)5E3E2 *nC9E2'.0 f3Ci;)2Cb I)54Ce3!)6 4r),)-3D6C3 ClE'SCi^n FSC'iC'J'iO 

F.'CSCTUA C50'iE340 t 3C IC 2D3 C'>E2C5C7 0<tCbO!>E3 '.Ot3ClC2 r)3C5'.0C3 ClD'jJ^D6 










Tnonnoco ooooooon 



i^OOCJOoO OVi'iib'Vfi 



On7H.0 30 l OOOOTOOO 

orocmoo ooooasfo 
0P"2C007 oo'.onos 



000711000 aP00E2»8| 4(3*B'VR'il-\ 'tll4l3'iR'»b 

OOOOOOOO POOOOOOO 070F2O0'-|0O00O90C 

FA0C8900 02nAFL5D (.0080000 T1;10A67E 

COOCOCOO OC07b3AA COOflOC f (. 0000 Aft7e 

'.009.j8'»0 00O2O0O0 ooooooooit-o; , (; po t^^ 



000500 
. 00052O 
^0005*0 
000560 
000590 
0005AO 
0005C0 
0005E0 
000600 
000620 



0006C0 
0006EO 
000700 
000740 
000760 
000780 
0007AO 
0007CO 
0007E0 



000800 
000820 
000840 
000860 
000880 
0008AO 
0008CO 
0008EO 
000900 
000920 



296 |4?97y .389 
46 3000 00 3f.)CC3C4C 
OOOOOO'^O C4A01PC0 



00017000 Jo Zl0n50E6| 
6Ofl00SO0^OO0;7f)SFC 
ooooooon \0'>00793«' 
O000A5E2 loiS^k^YlO 

00081018 \oo2conr.o 
0)000000 hooooooo 

00006308 /OCOOOOOO 



3FO03F06 [3FOCj3P'= ■ '"' 

3E8C0OI.) 0'''f>00'y(«M|6>T5 
00000588 COCOO -K 

0032002C loops ' ' 

OOOOCOC'.' 



OOOOCIOO 60P0t 



1C0OOOO 



J000070( 

:r7 /""""-" '-"> }'"":"}0 OOOOf 04( 

/fc4^fCV> //i/^oWiT^-^) 0000 3A8C 



«%» ■mjPTTW^nTTOTIWFB' 

COPOO 00008299 00006088 

0)007480 

3 00000760 

OCOOOOOC 

COO 0''000000 



7^ 

Fipr/? 



00 OOOOOOOC |0141|0003l JOOrOE640|IOO)ODE 88| 0000F2»r I0C006378 
00 OOOCO OOM 000 3FFFFl/0OO0492Or«0C70O0O 10001004 3 0145.C:)r,0 

^ ' ■ '->/>■«'"■ "^^ 't h-77 — -7*v__;.^_^ l_^C1j 



00000000 
00020008 

00830083 
00830083 
00004036 
00003EF0 
00000000 
061)00680 
95030585 



41HHP01F 
937E9463 
07FF960C 
416008FC 
06f(006BO 
30020787 
07F74880 
072F94FE 
9500060F 
U91D9000 



00000000 
00C20'i06 
— SAMt — 
83838300 
00009260 
00100000 
000006(30 
06B006BO 
47700826 



07F6084C OOuuuuuu 
080A0COE 00183048 

OCOOOOOC OOOOCOOO 

OOCOOOOO 00000000 

00007118 000071DO 

06B006B0 06B006B0 

06B006BO 06B006BO 

459008C2 47F00326 



PACE 
\ TA0I- e 

nel»H/)^ of 



cpo CfiO 



- . . J'JOO '.,". 

00000002 O0OUUOO3 

00C0728S 00007340 

06B04BSO O6E206B0 

06B006B0 06B041BB 001F41BR 0010181 

06B006B0 06B006BO 06B006flO 06B006B0 



CPU. ID 
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06RO06H0 
300642B0 
AOOFAFOl 
07FF06B0 
06B006rtO 
18414340 
04CE8ReO 
058207F9 
47800A5A 
00140919 



41BB001B 
A00158B0 
01AE4400 
06R006BO 
06B0AF05 
30028940 
00034 188 
4590C6C2 
AD03I)99C 
06C 04780 



45700896 
065C960C 
R97A077F 
068006BO 
010O50B0 
00035A40 
00384188 
9283A000 
95000585 
09061BAA 



58900554 
AOOFAFOl 
92r0050F 
06B006BO 
00C0a200 
056418A1 
06C0928 3 
5880A004 
47700AA4 
50A0050C 



4ir09244 
OlAe95l0 
9283074 1 
06800680 
06581811 
43AC/4007 
80009200 
50008030 
02101)910 
ACFCl»99C 



12114770 

A001078F 
92000599 
06B0C6B0 
D3000680 
4AA004FA 
05859204 
92008030 
09324890 
43A10015 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 






oo; AMe^ °^ 

003BCO oooooool 



/>/SZ A^y^ ^ ^f 



^^ 



003BEO 
003COO 
003C20 
003C40 
003CC0 
O03CE0 
003000 
003D20 
003D40 
003060 

fV 0030A0 
V 0030CO 




60000004 0800E7E8 OOOOOAOl 
C2C4E4D'V D7A01700 000070AO 
00000000 00000000 00000000 
^04A0OOO0 0002000B OOOOOOOO 



OOOOOOOCH^O^AgjDOOO 00020007_ 00000000 0010000pT45900036 00020007 OOOOOOOO 

00200000 4^ir00"0"6"2" "o"o"Oo666o" "OOO'obbod" " "o"030"0"o"o"o"4450008E 00020007 OOOOOOOO 

00400000 I »3b6o6bA flA66(l)ooo oooooooo oosooooo oooooooo oooooooo^jjnnooooo 

OOOOOOOO — SAME — 



V 



P(B2 






000E2880 8200C2C7 80040000 00006458 
80441E80 8000C6F3 80007800 00006508 
009C1E80 a0OOC6Fl 80008800 00006758 



OOOOOOOOl aOOO fclD^T OOOOOOOO 000063E8 



oooooooo 80000000 oooooooo 000068D8 

oooooo oo 80000000 oooooooo 00006A58 

B3OTniTOo--«Qgooooo oooooooo 00006BO8 

oooooooo BOOOWlpO oooooooo 00006D58 

oooooooo SOOOOobo oooooooo 00006E08 



O00E288O 8200C6F4 80061000 00006S18 
00701EOO 8300C6F2 80089000 00006698 

oor.BiFnnl flnoooooo onnoonnn onnn6aiH 



oooooooo 80000000 oooooooo 00006998 
oooooooo 80000000 oooooooo 00006B18 
oooooooo 80000000 oooooooo 00006C98 
oooooooo 80000000 oooooooo OOO06E1B 

000000001 00000000 oooooooo oooooooo 



PIB 





004000 
004020 
004040 
004060 
004080 
0040A0 
0040 CO 
040EO 
^(J54100"~ 
004120 
004140 
004160 
004180 
0041A0 
0041C0 

,o\ 004240 
jlJfc'7004260 
004280 
0042A0 
0042C0 
0042E0 
004300 
004320 
004340 
004360 
004380 
0043A0 
0043C0 
0043EO 
004400 
004420 
004440 
004460 
004480 
0044A0 
0044C0 
0044E0 
004500 
004520 
004540 
004560 
004580 
0045AO 
0045CO 
0045E0 
004600 
004620 
004640 
004660 
004680 
0046A0 
0046C0 
0046E0 
004700 
004720 
004740 
004760 
004780 
0047A0 
0047C0 
0047E0 



FFFFFFFF 
FFFFFFFF 
07FFFFFF 
FFFFFFFF 
FFFFFFFF 
t=FFFFFFF 
FFFFFFFF 



6201 Q)€^ro<X■ */ 

ooof 




FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 
lOFFlOFF 14FF15FF 00FF07FF 06FF0606 
07090707 07FFFFFF FFFFFFFF FFFFFFFF 



FFFFFFFF FFFFFFFF 
OBFFFFFF 07FFFFFF 
FFFFFFFF FFFFFFFF 



FFFFFFFF ISU/i^ FFFFFFF ppFFFFFF 



)BFFFFFF 07FFFFFF 07FFFFFF FFFFFFFF 



-^«i«te ^»* » Pt*hJ^ /fey^w/fl^ 



OFFOO 
itFFOO 



50C3 
50C3 



oo ooooo o' 

SANE 

oooooooo 

00000002 
OOOOOOOO 



:C0|FF0OOOO0 



0130FF00 
40FO0OOO 

Jld666F8 

620002F8 
620402F8 
50C300C0 
50C302C0 



6 20000F8 
Q0D0O5OB 



OOOEFFOO 
0131FFO0 
0260FFOO 
02A2FF0O 

tSliJFFo'o" 



Ff 66666fl 6666(5666 FPfl6(i666 oooooooo ffoooooo 



oooooooo^ 
oooooooo/ 



1000 
00020008 

oooooooo 



00010001 
00000002 

oooooooo 



00010000 
00010008 

oooooooo 



OOOOOOOB 
00080000 
OOOOOOOO 



FF80FF49 

ooooocoo 

00001400 
OOOOICOO 
00002400 
00002C00 
00003400 

ooooffoo 
ooooooffI 



6628FF00 

oooooooo 

00001500 
OOOOIDOO 
00002500 
00002000 
00003500 
06FF0000 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 

ooooao6C 

40404040 



oooooooo 

FD7FCED3 
F3F3F4F0 
000073F8 
40404000 



05064005 
0OO0CE5O 
00003CD4 
00003864 
40404040 



hmuhh 

C1D4C540 
002E40FD 
0000003C 
3BD45A30 
40404000 



C428FF15 
OOOOOFOO 
00001700 
OOOOIFOO 
00002700 
0OOO2F00 
00003700 
OOOOOOOO 



OOIFOOOO 
OOOOOB 

ooooPs 



J F1F261F0 
OOOOOOOO 
41044296 
48100000 
OOOOOOOO 



9C28FF15 
00001000 
00001800 
00002000 
00002800 
00003000 
00003800 
OOFFOOOO 



9C2 8FF15 
00001100 
00001900 
00002100 
00002900 
00003100 
00003900 
OOOOOOFF 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
00008075 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
00007340 
40404000 



C3C1D3C3 
30804E00 
00003CD4 
00003864 
40404040 



OOOOOOOO 
OOOBFFFF 
F2F0F6F7 
0000807E 
40404040 



OOOOOOOO 
FD7FCE03 
F3F3F4F0 
00007288 
40404000 



D50640D5 
OO0OCE50 
00003C04 
00003864 
40404040 



E2C90440 
002E40FD 
0000003C 
3B045A30 
40404000 



J F1F261F0 
OOOAIFFF 
41044296 
47980000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010E0 



C1D4C540 
002E40F0 
0000003C 
3B045A30 
40404000 



J F1F261F0 
OOOOOOOO 
41044296 
47200000 
OOOOOOOO 



TSSTTTFT 

0008AFF6 
42974389 
3DCC3E4C 
04A010EO 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



76667666 

0008D4DF 
3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000050 
3F0C38F1 
00000050 
C0C0OO40 



OOOOOOOO 
F07FCED3 
F3F3F4F0 
00007100 
40404000 



OOOOOOOO 
OOOOOOOO 
00790000 
00000019 
OOOOOOOO 
00510000 
00000013 
OOOOOOOO 
00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 
OOOOOOOO 



oooooooo 

OOOOOOOO 

oooooooo 
oooooooo 
oooooooo 
oooooooo 

03E80000 
OOOOOOFF 

oooooooo 

03E60000 

oooooooo 
oooooooo 
oooooooo 
oooooooo 



002E40F0 
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3B045A30 
40404000 



J F1F261F0 
00074FFF 
41044296 
46A80000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
3DCC3E4C 
04A010E0 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



00000040 
3F0C38F1 
00000040 
C0C0OO4O 



F661F7F3 
00063C5B 
42974389 
30CC3E4C 
04A010EO 



OOOOOOOO 
00510000 
00000013 
OOOOOOOO 
00500000 
00000019 

oooooooo 

FFOOOOOO 
00000019 
OOOOOOOO 
00500000 
OOOOOOOO 

oooooooo 

00790000 



oooooooo 
oooooooo 

03E 80000 
OOOOOOFF 
OOOOOOOO 
03E 80000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 

oooooooo 



OOOOOOOO 

oooooooo 

03 E 80000 

oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 
oooooooo 

03 E 80 000 



70007000 

oooooooo 

3F003F06 
3EBC0010 
00000588 



oooooooo 

00000030 
3F0C38F1 
00000030 
COC00040 



JFA66666 

00000019 

oooooooo 

00500000 

oooooooo 
oooooooo 

00790000 
00000019 

oooooooo 

00510000 
00000013 

oooooooo 

00500000 
00000019 

oooooooo 



oooooooo 
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00000020 
C0C0OO4O 



■/\/o // m L(/B /Ui:Jr /i'/i/o /3 ^ A^ 



LUB 



■/=^oc 



■FOB 






5 
3 « .. . fZ 

■64 381 
&>v4u, in T/S - S 

■T»B ^ 



TU 



Fl 




pk (kENSLOo£) / 

' ' [/...K.. T 



BLOCK 009 

004800 00500000 OOOOOOOO 00000019 OOOOOOOO OOOOOOOO OOOOOOFF FFOOOOOO OOOOOOOO .&. 



•(gnmia) 



Figured part 3 of 20 



Appendixes. A. 13 



Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



005080 
0050AO 
005DC0 
0050E0 
005E00 
005E20 
005E40 
005E60 
005E80 
005EA0 
005EC0 
005EEO 
005F00 
005F20 
OOSF-VO 
005F60 
005F80 
005FA0 
005FCO 
005FEO 



>16't6; 
00454780 
95207003 
90001000 



E4724B60 06E25060 00484166 00080300 
92036000 47F0E386 D207E23C 00400203 
4720.E56C 4710E472 9 1020044 4710E472 



0040E23C 07F 



7798203A 
E680203A 
OOOOFFO 
OOOOFF^O 

oooof/oo 

OOOOfFOO 

OOOOfFOO 

OOOOkFOO 

OOOOF 

OOOOFFOT 

OOOOFFOO 

OOOOFFOO 



no6 1i,tii(iU OAFF OaOfl 

3000 



0000 OOOOFFOO FFFFOEOO 0000FFT3 




7730203A 
-Z«6a2P3A 



0048E215 
0048E230 
50601 






<?^ 



FFFF3100 OOOOFFOO FFFFFFOO OOOOFFOO 



AAAOAAAA fljflflflflfifl AAAfidOOd 6M6d6oo 03000000 

00000000 00000000 05000000 00000000 00000000 

07000000 00000000 00000000 08000000 00000000 

00000000 OAOOOOOO 00000000 00000000 OBOOOOOO 



04FF0B00 

04FF0900 

FFFFOFOO 

= FF1300 

= FF1700 

-FFIBOO 

=FF1FOO 

I-FFF2300 

FFFF2700 

■='=FF2B00 

5FF2F0O 

FFFH 0014 

00000000 

06000000 

00000000 

00000000 



96407000 

wrrr 

03000048 



47F0E386 

yLUUiuuu- 

E2150207 



39A0033C 
78D0203A 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 



OfFFI OSod" 
06FFFF0O 
04FF0C00 
FFFFIOOO 
FFFF1400 
FFFF1800 
FFFFICOO 
FFFF2000 
FFFF2400 
FFFF2800 
FFFF2C00 
FFFF3000 



0106666O 

00000000 
00000000 
09000000 
00000000 



00000000 
04000000 
00000000 
00000000 

ocoooooo 



..ii.»;--.i «.K. 



CHftNQ 



OZ , uKi«A en oAeurte^ 



BLOCK 012 



006000 
006020 
006040 
006060 
006080 
0060A0 
0060CO 
006OE0 
006140 
006160 
006300 
006320 
006340 
006360 
006380 
0063A0 
006 3C0 
0063E0 
006400 
006420 
006440 



00000000 OOOOOOOO 00000000 00000000 
OFOOOOOO OOOOOOOO OOOOOOOO 10000000 

, iooooofl_awtouuutr 

rPAoe/UL ^;2<t»t>e. -♦•'TT'oo OOOOFFOO 
' ^' 1000000 FFOOOOOO 

Oi^ ^/l/' lOOFFOO OOOOOOFF 

/ 1000000 OOOOOOOO 



■5C//£^/^c? 



OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
007A0013 
OOOOOOOO 



— SAME— 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



1000E600 
OOOOOOOO 
00200040 
OOOOOOOO 



OAOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



OOOOOOOO OEOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO l lOOOOOQ OOOOOOOO 
13000000 OOOOOOOO TJTWeoaCO FFOOOOOO 
OO0OoB~»«ltF00OO 
OOOOFF 000 
^i^fat/* <^ C/TA^ 000000 2000200" 
( 000000 OOOOOOOO 

410C0400 OOOOOOOO O00OE7E8 10000000 
OOOOOOOO 4000E9CO OE000005 00000400 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO loooooo6fll 066SB606 066S66i>6 



IsBsadiCJ CJfl^B^CU ABCHAAC h^WiUl IflflflaflOflfl 53666600 06600000 00000000' 



00040000 OOOCOOOO OOOlfOOO 0001E800 00040000 000610000001E800 00021000 
00061000 00075000 00021000 00023800 00075000 00089000 00023800 00027000 
00089000 O0OA2O00 00027000 0002A800 000A2000 OOOCOOOO 1 01310000 OOOOOEIO 



00000E74 
000086BB 
00089000 
OOOOOOOO 



HOTFTTT 

000084BA 
FFFF7D18 
— SAME— 



F IFI F I F I 

00008534 
00008340 



6fl66C45C 

8000837A 
00008660 



070D1000 00008460 000085D8 000084CA 
000082E8 00008318 00008308 00089040 
00004450 OOOOOOOO OOOOOOOO OOOOOOOO 













009 3C0 
0093E0 

coa'ioo ■ 

009480 
0094A0 
0094C0 
0094EO 
009500 
009520 
009540 
009560 
009580 
0095AO 
0095CO 
009 5E0 
009500 
C09620 
009540 
009650 
009680 
009 7E0 



F2F3F4F5 F5F7F8Fa 



■'^-30503 C9C7D506 



40404500 CI 0940' /«/ /{lji($«44 e/ /'^ (i/«9 )0000 OOOOOOOO 44»»t« <^ (LC^cIk. f^/^/l> 

O0B44|/0O000C56 00009F 
C7E3E6r FFrF3009 FF^^FF 
FFFFFF FFFFFFFF 0003FF 



I456789ABC0EFCA ^4CELIGN0RE 



99FF)l 0000479C 
00001000 



0000158E OOOOB 



00000330 0300479B 0030- .- . 

FFFFFFFF |O0O3D80O||O003FFFOl 3 FOE 



^D7:4C1 



)9F02 



C9 C4C1 



FFFFF ^- s ^< T—^ / '^a*^ <?/ -° *2C0910B 58CO00 

'''"°' /\cUe*i <^ AdU^'f Zy/'/ 58 078A95FF 910607 

078A5"'*^ r "'"*. T ^iCl^J/ =F 80004780 S3CAD5 

lllV^St^Jf ^-<// ^^gf 70 9118D207 700000 



908F 
47109 

020193 (A '»iuA'yu5f Vl<!0^(5^^ VUJC 

1B651875 1B565D60 910C4C70 910E 

98579120 47F091CC; 41509120 5869 

9C6CAO0a OOOOOOOO OOOOOOOO 0000 

00003330 — SAME — 

OCOOOOOO OOOOOOOO OOOOOOOO 0000 
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8CO0080 9500C045 
78A 95FF910B 
00 80000083 
20 90017008 
31 70108002 4177D012 5970911C 
10 00000001 OOOOOOOO 00030800 
;0 90839049 02009089 904A0200 
•0 909F47F0 917090CA 91809058 
iO 928090C7 95009070 4770917E 
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EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 






5^/ 



OODE'iO 
000E60 
000E80 
OOOEAO 
OOOECO 
OODEEO 
OODFOO 
00DF20 
00DF40 
00DF60 
00DF80 
OOOFAO 
OOOFCO 
OODFEO 



OOEOOO 
00E020 
00E040 
00E060 
00E080 
OOEOAO 
OOEOCO 
OOEOEO 
OOEIOO 
O0E120 
00E140 
00E160 
00E180 
OOEIAO 
OOEICO 
OOEIEO 
OOE200 
00E220 
00E2«0 
0OE260 
0OE280 
00E2A0 
00E2C0 
00E320 
OOEB'fO 
00E360 
00E380 
00E3A0 
00E3C0 
O0E3EO 
00E420 
00E440 
00E4A0 
00E4C0 
0OE4EO 
00E500 
00E520 
O0E540 
0OE560 
00E580 
OOE5A0 
00E5C0 

I 006640 
00E660 
00E580 
00E6A0 
00E6C0 
00E6E0 
OOE700 
00E720 
00E740 
00E760 
00E78O 
00E7A0 
00E7C0 
00E7E0 



F0109200 
00000000 
00000000 



F7485870 
— SAME — 
00000000 



F6E'f07F7 98 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 



00030000 
00070000 
OOOBOOOO 
OOOFOOOO 
00130000 
00170000 
OOIBOOOO 
OOIFOOOO 
00230000 
00270000 
0O2B0000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 



O0u^.wv.-N| Q0020000 

iOCAflflOO ooo'2666o 



000000*0 ooQOOnoo oonooooo 

yjOOJJDOgO,' 00020000 



..6U.7..6H .7. 



00080000 

ooocoooo 

00100000 
00140000 
00180000 
OOICOOOO 
00200000 
00240000 
00280000 
002C0000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
'00020000 



00050000 0002000C 

00090000 00020000 

00000000 00020000 

00110000 00020000 

00150000 00020000 

00190000 00020000 

OOIDOOOO 00020000 

00210000 00020000 

00250000 00020000 

0029 0000 00020000 

goT^ooo; oooooiEO 



P/I<fe /^/^AM£ 7^i3C£- 



002201F8 
000002AO 
OOOOOICO 
00000100 
00000200 
OOOOOIBO 
00000410 
00000298 
00000280 
00000220 



00820268 
00810268 
00C70418 
OOC40208 
O13901F0 
013102B0 
01130290 
01160230 
01300270 
011A0258 



00220260 
00000210 
000001A8 
OOOOOIAO 
00000228 
00000248 
00000188 
00000270 
00000288 
00000190 



00830410 
FFFFOIEO 
00C601B8 
FFFF0170 
013A01F8 
01190298 
01170248 
013F0410 
01410278 
00C80198 



-ji.Laa£-/>^ <« sew/? 

00000208 00840240 

00000250 OOC5O1C0 

002202AO 00C20190 

00000268 013701B0 

00000108 00800188 

00000290 01120200 

00000240 01180220 

00000198 013501E8 

000002A8 01400280 

000002BO 01420288 



lOOOOOlFO 

o'ooooie's' 

00000418 
000001F8 
000002B8 
00000258 
00000230 
000C0278 
00000238 
00000218 



00020000 
00060000 
OOOAOOOO 
OOOEOOOO 
00120000 
00160000 
OOIAOOOO 
OOIEOOOO 
00220000 
00260000 
O02A0OOO 
FFFF0400 



013B02AO 
■0"l36'62i8' 
OOC301D8 
01380190 
FFFFOIAO 
01150250 
011401A8 
013E0260 
O13C0228 
O14302A8 



000002C0 FFFF0210 000002C8 FFFF02B8 

000002E0 FFFF02D0 00000268 FFFF02D8 

00000300 FFFFC 

00000320 FFFFC 

00000340 FFFFC 

00000360 FFFFC 

00000380 FFFFC 

000003A0 FFFFC)390 000003A8 FFFF0398 

000003C0 FFFF03B0 000003C8 FFFF03B8 






000002DO FFFF02C0 000002D8 FFFF02C8 
000002FO FFFF02E0 000002F8 FFFF02E8 
00 00000318 FFFF0308 
00000338 FFFF0328 
00000358 FFFF0348 
00000378 FFFF0368 
80 00000398 FFFF0388 
000003BO FFFF03A0 000003B8 FFFF03A8 
00000300 FFFF03C0 00000400 FFFF03CB 



00030360 
00030400 

6fla001B8" 



DOOOOOQ 00000000 00000000 oooooooo 



00000000 
oooooooo 



— SAM6 — 

oooooooo oooooooo oooooooo 



00400048 
00C000C8 
01400148 



00500058 00600068 00700078 
00D000D8 O0E00OE8 OOFOOQFB 
01500158 016001681 801 



100001 0008 00100018 00200028 00300038 



'00800088 00900098 OOAO0OA8 OOBO0OB8 
01000108 01100118 01200128 01300138 



aniisoii fioiianii aoiiao7i §, 

5E9 03F103F9 



pfiQe: 

80013001 

00150015 

00150015 

02A10025 

00250025 

00250025 
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00350035 

02490221 

00450045/ 

OIFIOIR 

005500/5 

0055a 



Oil 
18021 
8051 



800103D9 03EJ 

— SAME- 

00150015 jBt)150015 00150015 

0025002/^00250025 00250025 

SAMBt- 
0035^35 00350035 00350035 



/^C^)4^^ </■ 



0035 
D045 
D045 
5261 



zoioo irsoo nsco leooo is9oo^_ _ 

J0209]0199 I 0179|01 81 1 018131 0615 00150015 

rO015OO15 01C901D1 01D901A9 01C101B9 
00250025 00250025 00250025 00250025 



00350035 00350035 00350035 00350035 



00350035 02290239 02510231 02590241 



-FfFF en .^^ ^.^S 
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oooooooo 

06023D50 
80000000 



^ 00 oooooooy oooooooo oooooooo 

ff)bbl^tt> FflflOESBO rflOaEJFd) F(>( if E43o jFOoag4?a f ^ bbblK^b i^oio{4|iot 'I cn-r m^^.,-,- 
F000E570 FOO0E5BO F0O0E5F0 I OOOocretrf 66666661 dflfl666(l>i oooooooi j btCrneNT 
" T/fSi-f" 



UU55UU55 0U550U55 00550055 



00062004 56fl6Sfl36 6S66l!ilii 
oooooooo oooooooo oooooooo 

00OOE908 0702301C 60000006 
600000AO 92023D38 20000005 
000B9CE0 88000000 0000E998 



OOOOOOOO OOOOOOOO 0020COOO 000614E8 

OOOOOOOO oooooooo oooooooo oooooooo 

31023Q1E 60000005 0800E600 OOOOOOOO 

oooooooo oooooooo oooooooo oooooooo 
05013074 i6666620 09018094 20000025 



-"- ^7 _ , - /79bo 



oooooooo 
I oooooooo 
oooooooo 
oooooooo 

00008000 
000066C8 

oooooooo 



ccw Copy BLOCK 



88C00000 






'/e <y^«l 






BLOCK 029 



CCS Mtn^ 

00E800 I <i<* ju>t,nA</ c5? /tfo8- 

O0E820 I 88/ _^ 



l^i 



-/^w^ ^ ft^ CC y (c/ta^i^ne/ /ro^t^x^^) 



00E840 
00E860 
OOE880 
00E8A0 
00E8C0 
00E8E0 
00E900 
00E920 
O0E940 
00E960 
00E980 



09un,'<Bt <:uuuuun, uuu><uuOO OOOOOOOO 
OOOOOOOO OOOOOOOO 80<500000 nnrvAlKnn 
OOOOOOOO — SAME — / 

OOOOOOOO 00000000/10000000 

00008000 0C002003(0000E758 
OO0OE758 00000000 *00000000 /booooooo 

1 00000000 oooQF75a I 0000Q40CW00002004 ' 
OOIOCOOO 1 000417121 lo<y)OE7EaiO0IOOE95C 
oooooooofoooooooo oooooooo oooooooo 

OOOOOOOO /^<'6!^«*> <^ Vl^f^ilttJ^ oc6 



oooooooo OOOOOOOO OOOOOOOO OOOOOOOO 

Donnnnnn /inr,A/>nnn ,cnn.ro-,n 1000005A 

ccw Copy 0LOCK ^--^ D0OE8CO 

DOOOOO OOOOOOOOi 



ccw copy BLOCK 

''^ On a yt^*ka, of Z) 



CCW ac/a^^^ <^ C%W 



-/lcU^ey>^ oj^ /^/*<1 i^^ra^ 



fi CCB Co/>y 0JiocK 



i:e>/)L SK.OCK 



'C£xie6KT)\ 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



o 



_ BLOCK 0*7 
















017800 


40400440 40404040 C1D4E240 40404040 40404040 


40404040 


4040C340 


7E4004C9 


N AHS 


C . MI 


^ 017820 


D5C4C5D9 40C2C5D3 CID5C709 C9D1D24B 40E5C509 


C4C5D9C5 


400605E3 


E6C902D2 


NOER BELANGRIJK. 


VEROERE ONTUIKK 


• 017840 


C503C9D5 C740E5C1 D540E2C9 E3E4C1E3 C9C540D4 


D6C5E340 


C1C6C7C5 


E6C1C3C8 


ELING WAN SITUAT 


IE MOET AFGEMACH 


017860 


E340 




)40 


D5C9C5E3 


40E5C5D9 


06D5E309 


T WOROEN D . .N 


OG. NIET VERONTR 


^ 017880 


E4E2 




>06 


09C4E340 


C7C5C505 


40C1D2E3 


USTENO. VOORLOPI 


G MOROT GEEN AKT 


• 0178A0 


C9C5 




)40 


40404040 


40404040 


40404040 


IE ONDERNOHEN 




0178CO 
_ 017960 


4040 
4040 


Fur 00 ooi^\>«ut. olcw^^ ooof 


;40 


40404040 


40404040 


40404040 


** AFKQRTINGEN 


•* 


• 017980 
017A20 


4040 
4040 




)40 


E5060609 


0306D7C9 


C75040C1 




• .VOORLOPIG. A 


^ 017A40 


C6C7 


'C5 


05E3C9C5 


4040D7D3 


E3407E40 


F6EHERKT U6N . 


URGENTIE PLT . 


• 017*60 


0703 


>D9 


C7C505E3 


C9C5C3D6 


C4C57A40 


PLAATS 


URGENT I ECODE. 


017A80 


4040 


■em4y 0^ . 


)40 


40404040 


4040C140 


7E40C8D6 




A . HO 


^ O17AA0 


D6C7 


fC5 


0303C9D1 


02C540C1 


02E3C9C5 


OGST URGENT. QNH 


lODELLIJKE AKTIE 


-• 017AC0 


40E5 


(/;»- CC» CoPV Alock)^ £7£Z 


140 


40404040 


40404040 


40404040 


VEREIST 




017AE0 


4040 


iC.7 


D9C9D102 


4B40C102 


E3C9C540 


B . BE 


LAN6RIJK. AKTIE 


_ 017800 


C9D5 


)40 


40404040 


40404040 


40404040 


IN NABIJE TOEKOM 


ST 


• 017B20 


4040 


>40 


40404040 


40000000 


00000000 






017B40 


0000 










.... 




^ 017E60 
• 017E80 


0000 
0000 


JOO 
)00 


0000005C 
0000012C 


00000000 
8004033C 


OOOOOOOC 
00000000 










017EA0 
_ bl7EE0 


0000 
0000 


889 200Ufl0BWc2h4tf40 C7C5D5C5 D9Cli 
5C5|4040404o1e2C503C5 C3E340CI 40C2E 


)F6 


404040F1 


404040F5 


404040FO 


III!.. ..TOMS 12 


6 15 


































_ 017F40 


0904 


rF3 


6000001 F 


09041812 


60000021 


....- 0-... 


...3- -... 


• 017F60 

017F80 

_ 017FA0 


0904- 
0A041 
E3C9E 


374 
306 
4C7 


60000020 
D940D9D6 
40C2E840 


09041894 
E4E3C9D5 
C505E3C5 


20000025 
C540C1C3 
D9C905C7 




....—........... 


^.::r.AfBUG gene 


ftAYoft ftOUTINE AC 


/ TIVEI select a 


BUG BY ENTERING 


• 017FC0 


40D605C5140404040/D6C640E3 C8C540C6 D6D303D6 


E6C9D5C7 


40D3C5E3 


E3C509E2 


ONE OF THE F 


OLLOWING LETTERS 


017FE0 


40C6D6D3|03D6E6CS/C440C2ES 40C506C2 4B404040 


40404003 


40404DC5 


D5E3C5D9 


FOLLOWED BY EOB 


L .ENTER 






^ V'^ ^c^^c^;^ 4r u 


^PScrvy^li/te</ l^ 


/'r CZI^^ 






BLOCK 048 
















• 018000 


40C1D540 E405C5D5 C4C905C7 40D3D606 D75D4040 


4040C940 


404D07D9 


D6C4E4C3 


AN UNENDING LOO 


f.: ■» •''??P^-*'/<'7/r7:) 



03FDC0 
03FDE0 
03FE00 
03FE20 
03FE40 
03FE60 
03FE80 
03FEA0 
03FEC0 
03FEE0 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
O3FFA0 
03FFC0 
03FFE0 



C5F20740 
00089024 
00a89A7C 
00089B58 
07402000 
9024C6F2 
9A7C0708 
98620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
074D2000 
9D24C6F2 
9A7C0708 
9B620008 
OOOOOOOO 



00000008 
C6F2074D 
00089D24 
00089A7C 
00089858 
074D2000 
9D24C5F2 
9A7C0708 
98620008 
00000008 
C6F2074D 
00089D24 
00089A7C 
00089B58 
074D2000 
9D24C6F2 
9A7C0708 
OOOOOOOO 



9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
9D24C6F2 
9A7C0708 
9B620008 
00000008 
C6F2074D 
00089D24 
00089A7C 
00089B58 
07402000 
9D24C6F2 
OOOOOOOO 



9A7C0708 
98620008 
00000008 
C6F20740 
00089024 
00089A7C 
00089B58 
07402000 
9024C6F2 
9A7C0708 
98620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
OOOOOOOO 



9D24C6F2 074D2000 00089858 00089A7C 
9A7C0708 9024C6F2 07402000 00089858 

^J^ -Trirt^ /"^ /^^ ^ -^ 

/^ ^ /"^J/?//* ^S(/C ^rn/Lg. 

ouuB-iu^;* i,«>r<;uf40 uuuuuuyo ~<oo<;uuub 

00089A7C 00089024 C6F2074D 00000008 

00089658 00089A7C 00089D24 C6F20000 

OOOOOOOO OOOOOOOO OOOOOOOO oooooo jool 



o 



.^;x:::. 



..F2 F2 



..r.F2*.i!i*.r.ir. z'//?'/^ 9$\/c 

F2.. ^icce. &tyV<Jli 



040000 OOOOOOOO 00000000 00001 

040020 — SAME — 

0407E0 OOOOOOOO OOOOOOOO 0000( 



BLOCK 129 






00 OOOOOOOO 
00 OOOOOOOO 



040800 OOOOOOOO OOOOOOOO 0000( 

040820 — SAME— 

040FE0 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



00 OOOOOOOO 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



3FFFI= 



Cia/i/' J^ ,^ re<t£ cu)44^^ a/^\ 



(jU 



CPO 



BLOCK 130 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
— SAME — 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
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Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 




■ 


HHHHI 




m 


jfBIHI 




■ 


1 


IJBSEGT CONTENTS IS TAKEN TC 


LOCATE THE SEGMENT TABLE 


1 


1 


• VIRT.AOOR 


REAL ADOR 
000000 


BLOCK 
000 


STATUS 

CHANGED "\ 
CHANGED 




I 




k 000000 


^^1 


^ 


000800 


000800 


001 




^^1 


^^1 




001000 


001000 


002 


CHANGED 




^^1 


^^1 




001800 


001800 


003 


UNCHANGED 




^^B 


^^1 




002000 


002000 


004 


CHANGED 




^^B 


^^1 




002800 


002800 


005 


CHANGED 




^^B 


^^1 




003000 


003000 


006 


UNCHANGED 




^^1 


^^1 




003800 


003800 


007 


CHANGED 




^^B 


^^1 




004000 


004000 


008 


CHANGED 




^^1 


^^1 




004800 


004800 


009 


CHANGED 




^^1 


^^1 




005000 


005000 


010 


CHANGED 




^^1 


^^1 




005800 


005800 


Oil 


CHANGED 




^^1 


^^1 




006000 


006000 


012 


CHANGED 




^^1 


^^1 




006800 


006800 


013 


UNCHANGED 




^^1 


^^H 




h 007000 


00700r 


014 


CHANGED 


/ ^ i 


^^H 


H 


* .^ 007800 
C.O>r 008000 


007800 
008000 


015 
016 


CHANGED 
CHANGED 




H 


1 


\Q 008800 
_ 009000 
• 009800 


008800 
009000 
009800 


017 
018 
019 


CHANGED 
CHANGED 
UNCHANGED 


I 


^^1 




OOAOOO 


OOAOOO 


020 


CHANGED 




^^B 


^^1 




O0A800 


OOA800 


021 


CHANGED 




^^1 


^^1 




008000 


OOBOOO 


022 


CHANGED 




^^B 


^^1 




0O8800 


O0B8O0 


023 


CHANGED 




^^1 


^^1 




OOCOOO 


OOCOOO 


024 


CHANGED 




^^B' 


^^H 




0OC800 


OOC800 


025 


CHANGED 




^^B 


^^1 




OODOOO 


000000 


026 


CHANGED 




^^B 


^^1 




000800 


00D800 


027 


CHANGED 




^^B 


^^H 




OOEOOO 


OOEOOO 


028 


CHANGED 




^^B 


^^H 




00E800 


00E800 


029 


CHANGED 




^^B 


^^H 




OOFOOO 


OOFOOO 


030 


CHANGED / 




^^H 


■ 


w 


OOF800 


00F800 
010000 


031 
032 


CHANGED / 
CHANGED > 




I 


- 010000 


^^^ 


• 010800 


010800 


033 


CHANGED 




^^B 


^^H 


011000 


011000 


034 


CHANGED 




^^1 


^^H 


A 011800 


011800 


035 


CHANGED 




^^B 


^^^ 


• 012000 


012000 


036 


CHANGED 




^^B 


■ 


012800 
^ 013000 
• 013800 


012800 
013000 
013800 


037 
038 
039 


CHANGED 
CHANGED 
CHANGED 


) 'Se.j^rxjz^ 1 , o^ /i^ Aye4> ^ fe<i/ yi^^C^^ef^ ^4(y^ 


■ 


■ 


014000 
^ 014800 
~ 015000 


014000 
014800 
015000 


040 
041 
042 


CHANGED 
CHANGED 
CHANGED 


^ yij^^A^nije*^ CciA^ ^ ^ 


I 


1 


015800 
^ 016000 

• 016800 

• 03D800 
03E000 

^ 03E800 


015800 
016000 
016800 

030800 
03EOO0 
03E800 


043 
044 
045 

123 
124 
125 


CHANGED 
CHANGED 
CHANGED / 


)//(, /to^ fttttn 5ef^«^»tA -^t^y^Jft/^"'-^ y 


1 


I 

CHANGED ^ 

CHANGED 

CHANGED 




1 


• 03F000 
03F800 


03F000 
03F800 


126 
127 


CHANGED 
CHANGED ) 


1 


1 


• 040000 
040800 

. 041000 

• 041800 


020800 
019800 
017800 
018000 


065 
051 
047 
048 


CHANGED -) 
CHANGED ( 
CHANGED f 
CHANGED ) 




1 


1 


042000 

061000 
■ ,». 061800 


018800 

01C800 
OlDOOO 


049 

057 
058 


CHANGED J 

CHANGED 7 
CHANGED i 


1 


I 


IHHiHI 




n 


HHH 




1 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



I 


^ 09E800 027800 079 UNCHANGED A y <! , „^^ 9 

• 09F000 027000 078 UNCHANGED - /V* <* ^ e^«n»***^ / 

09F800 026000 076 UNCHANGED —J V ' 






• OAOOOO 028800 081 CHANGED -) , 
0A0800 028000 080 CHANGED ( <,*j,m^^J' /O 

^ OAIOOO 02A800 085 UNCHANGED C j«^'to»/» 

• ^^ 028000 0a6 UNCHANGED ) ^ Z ..^^ ^ o/^^^r^ ^^ ^ 




■ 


^ STORE STATUS FUNCTION NOT EXECUTED. CR IN INITIAt STATUS ** 




1 


CR 0-7 OOOOOOEO 00000000 FFFFFFFF FFFFFFFF 00000000 00000000 00000000 00000000 
_ CR 8-F 00000000 00000000 00000000 00000000 00000000 OOOOOOOO C2000000 00000200 , 







HHI 


[llflllljll 


HHH 










HHI 


■ 




• 




**• 


COHMUNICATION 


REGION *** 








1 




_ HEX 


BG 


F4 


F3 


F2 


Fl 






^^H 




• OISP 


04A0 


4590 


44F0 


4450 


43B0 


COMMUNICATION REGION ADDRESS 




^^P 




00 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


12/06/73 


DATE 




^^H 




_ 08 


7000 


7000 


7000 


7000 


7000 


PP8EG AOOR 




^^1 




• OA 


7000 


7000 


7000 


7000 


7000 


END OF STORAGE PROTECT 




^^1 




OC 


0000 


0000 


0000 


0000 


0000 


SEEK ADDRESS BLOCK. ONLY BG VLD 




^^B 




_ OE 


0000000000 


0000000000 


0000000000 


0000000000 


0000000000 


PROBLEM PROGRAM USERS 




^^1 






OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


AREA IN HEX 




^^B 




17 


00 


00 


00 


00 


00 


UPSI BYTE IN HEX 




^^B 




A 18 


TOMSOMP 


KENSLOOP 


NO NAME 


CALCSIM 


NO NAME 


JOB NAME 




^^B 




• 20 


00060FFF 


00074FFF 


OOOOOOOO 


OOOAIFFF 


OOOOOOOO 


UPPERMOST BYTE OF EACH PPA 




^^H 




24 


0004232F 


00063C5B 


OOOOOOOO 


0008 AFF6 


OOOOOOOO 


END AOOR OF LAST FETCH OR LOAD 




^^1 




_ 28 


0004232F 


OOOOOOOO 


OOOOOOOO 


0008D40F 


OOOOOOOO 


LARGEST PROBLEM PROGRAM PHASE 




^^P 




• 2C 


0000 


0000 


0000 


0000 


0000 


LENGTH OF PP LABEL AREA 




^^1 




2E 


0040 


0020 


0030 


0040 


0050 


PROGRAM IDENTIFICATION KEY 




^^1 




A 30 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


OOOBFFFF 


END OF STORAGE ADDRESS 




^^B 




• 34 


FD 


FD 


FO 


FO 


FO 


MACHINE CONFIGURATION 




^^B 




35 


7F 


7F 


7F 


7F 


7F 


SYSTEM CONFIGURATION 




^^1 




3_ 36 


CEO33OA0CEO0 


CED33000CEO2 


CE030000CE50 


CED330804EOO 


CE030000CE50 


JOB CONTROL SWITCHES 




^^B 




a» 3C 


002E 


002E 


002E 


002 E 


002E 


DISK AOOR OF LABEL CYLINDER 




^^1 




3E 


40F0 


40FD 


40FO 


40FD 


40FO 


AOOR OF FOCL 




^^1 




_ ao 


4104 


4104 


4104 


4104 


4104 


AOOR OF PUB 




^^1 






4296 


4296 


4296 


4296 


4296 


AOOR OF FAVP 




^^B 




44 


4297 


4297 


4297 


4297 


4297 


AOOR OF JIB 




^^1 




_ 46 


4389 


4389 


4389 


4389 


4389 


AOOR OF TEB 




^^1 




• 48 


3F00 


3F00 


3F00 


3F00 


3F00 


AOOR OF FICL 




^^1 




4A 


3F06 


3F06 


3F06 


3F06 


3F06 


AOOR OF NICL 




^^1 




m. '^C 


3F0C 


3F0C 


3F0C 


3F0C 


3F0C 


AOOR OF LUB 




^^1 




• 4E 


38 


38 


38 


38 


38 


LINE COUNT FOR SYSLST 




^^1 




4F 


120673340 


120673340 


120673340 


120673340 


120673340 


SYSTEM DATE 




^^1 




m. 58 


0000 


0000 


0000 


0000 


0000 


LIOCS COM BYTE 




^^B 




• 5A 


3CD4 


3CD4 


3C04 


3C04 


3CD4 


AOOR OF PIB TABLE 




^^H 




5C 


0000 


0000 


0000 


0000 


0000 


LAST CHECK POINT NO. 




^^1 




m, 5E 


003C 


003C 


003C 


003C 


003C 


JOB ZONE IN MINUTES 




^^1 




• 60 


4630 


46A8 


4720 


4798 


4810 


AOOR OF DIB 




^^1 




62 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNED 




^^1 




_ 64 


3DCC 


30CC 


3DCC 


3DCC 


30CC 


ADOR OF PC OPTION TABLE 




^^1 




• 66 


3E4C 


3E4C 


3E4C 


3E4C 


3E4C 


AOOR OF IT OPTION TABLE 




^^B 




68 


3EBC 


3EBC 


3EBC 


3EBC 


3EBC 


AOOR OF OC OPTION TABLE 




^^1 




. 6A 


0010 


0010 


0010 


0010 


0010 


KEY OF PROGRAM WITH IT SUPPORT 




^^1 




• 6C 


0000 


0000 


0000 


0000 


0000 


CURRENTLY NOT ASSIGNED 




^^B 




6E 


0000 


0020 


0030 


0040 


0050 


LTK 




^^1 




* 70 


00008090 


00008087 


0000807E 


00008075 


0000 80 6C 


SYSPARM 




^^1 




• 74 


00007118 


00007100 


00007288 


00007340 


000073F8 


JOB ACCOUNTING 




^^1 




78 


00003864 


00003864 


00003864 


00003864 


00003864 


AOOR OF TOO COMMUNICATIONS AREA 




^^1 




_ 7C 


3BD4 


3804 


3BD4 


3B04 


3 804 


AOOR OF PIB EXTENSION 




^^H 




• 7E 


5A30 


5A30 


5A30 


5A30 


5A30 


AOOR OF MICR DTF LABEL 




^^B 




80 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


AOOR OF OTAM VECTOR TABLE 




^^1 




m. 84 


04A0 


04A0 


04A0 


04A0 


04 AO 


AOOR OF BG COMREG 




^^1 




• 86 


lOEO 


lOEO 


lOEO 


lOEO 


lOEO 


RESERVED 




^^1 




88 


00000588 


0000OS88 


00000588 


00000588 


00000588 


AOOR OF COMREG EXTENSION 




^^1 




_ 8C 


COCO 


COCO 


COCO 


COCO 


COCO 


RESERVED 




^^H 




• 8E 


03 


00 


00 


00 


00 


DISK CONFIGURATION BYTE 


. .^"inm) 


H 




HBH 


IHHi 


HHH 










wmk 


1 
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Appendix G 

EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



O' 







■ 


■ 


■ 








■■■■m 


Hl^l 














*•• 


PHYSICAL UNIT BLOCK TABLE *»• 












• TOS 


CHAN 


CHAN 
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UNIT 
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•** COPIED AND TRANSLATED CCB *** 






• OOE908 






AOOR.OF CCB COPY BLOCK QUEUE 






0000 






RESIDUAL COUNT 






_ 04 






1ST COMMUNICATION BYTE 






• 00 






2ND COMMUNICATION BYTE 






0000 






STATUS BYTES FROM CSW 






^ 20 






LUB CLASS 






• 04 






LUB NUMBER 






0OOOE7E8 






AOOR.OF CCW STRING 






_ 00 






3RD COMMUNICATION BYTE 






• 041780 






CCW ADDRESS IN CSW 






0000000000000000 






USER SENSE CCW 






_ 0010 






PIK VALUE 






• CO 






FLAG BYTE 






00 






UNUSED 






_ 00041712 






AODR. OF VIRTUAL CCB 






• 00OOE7E8 






AOOR.OF CCW COPY. BLOCK 






0OOOE950 






ADDR.OF IDAL 






3 ^ 000000000001800000000000000000000000000000000000 


PAGES FIXED 






■^^ 00000000 






PTR TO FIXINF EXT 






00000000 


^_ 


^^ 


ADDR.OF NEXT CCB 


^^^^_ 


(ex/2f Hr) 


1 •** 


COPIED AND 


TRANSLATED CHANNEL PROGRAM »*• 


^^^* 




* 1 AOOR.OF ecu BLOCK 


COM. CODE 


DATA AODR. 


FLAGS BYTE COUNT VIRT.AODR.OF 1ST CCH 


ADDR.OF NEXT CCH BLOCK 




i 
^ 00E7E8 CCHl 


09 


017F88 


60 OOIC 041738 


O0E710 




• i CCW2 


09 


017FA4 


60 0020 






! CCW3 


09 


017FC4 


60 002F 






_ CCH4 


09 


00E950 


64 OOIF 






• i CCH5 


09 


018012 


60 0021 






1 CCM6 


09 


018033 


60 0021 






^ i CCW7 


09 


018054 


60 0020 






• 1 TIC 


88 


00E710 








1 TIC 


88 


000000 








• i O0E710 CCMl 


09 


018074 


60 0020 041770 


000000 




1 CCM2 


09 


018094 


20 002S 






^ ! CCW3 


00 


000000 


00 0000 






• CCH4 


00 


000000 


00 0000 
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00 


000000 
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**• SEGMENT TABLE *♦* **♦ 


PAGE TABLE 


*«* 










• ADOR.OF ST PT ENTRIES PT ORIGIN ADOR 
OOEb'fO 32 00E330 


VIRT.AODR 


REAL ADOR 
000000 


KEY 
00 


STATUS 
CHANGED 








L 000000 






000 800 


000800 


00 


CHANGED 










001000 


001000 


00 


CHANGED 










001800 


001800 


00 


UNCHANGED 








3 


002000 


002000 


00 


CHANGED 








3# 


002800 


002800 


00 


CHANGED 










003000 


003000 


00 


UNCHANGED 










003800 


003800 


00 


CHANGED 










004000 


004000 


00 


CHANGED 










004800 


004800 


00 


CHANGED 










005000 


005000 


00 


CHANGED 










005800 


005800 


00 


CHANGED 










006000 


006000 


00 


CHANGED 










006800 


006800 


00 


UNCHANGED 










007000 


007000 


00 


CHANGED 








S^f'tnji^ O 


007800 


007800 


00 


CHANGED 








008000 


008000 


00 


CHANGED 








/ 


008800 


008800 


00 


CHANGED 










009000 


009000 


00 


CHANGED 










009 800 


009800 


00 


UNCHANGED 










OOAOOO 


OOAOOO 


00 


CHANGED 










00A8O0 


0OA800 


00 


CHANGED 










OOBOOO 


OOBOOO 


00 


CHANGED 










00B800 


00B800 


00 


CHANGED 










OOCOOO 


OOCOOO 


00 


CHANGED 










00C800 


00C800 


00 


CHANGED 
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000000 


00 


CHANGED 










000800 
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00 


CHANGED 
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OOEOOO 


00 


CHANGED 
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00 


CHANGED 
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OOFOOO 


00 


CHANGED 
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00 


CHANGED 
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♦*» SEGMENT TABLE *•* 


• ** 


PAGE TABLE 
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• ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 


VIRT.AODR 


REAL ADOR 


KEY 


STATUS 








00E644 32 O0E37O 


010000 


010000 


00 


CHANGED 










010800 


010800 


00 


CHANGED 










OllOOO 


011000 


00 


CHANGED 










011800 


011800 


00 


CHANGED 










012000 


012000 


00 


CHANGED 










012800 


012800 


00 


CHANGED 










013000 


013000 


00 


CHANGED 










013800 


013800 


00 


CHANGED 










014000 


014000 


00 


CHANGED /, 
CHANGED, r/ ff fof- 










014800 


014800 


00 


^<? 








015000 


015000 


00 








9 


015800 


015800 


00 


^.effANGEO 








S€A^*^e^ ^ 


016000 


016000 


00 


•^CHANGED 








1 016800 


016300 
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CHANGED 

NOT ADDRESSABLE 
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017800 
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NOT ADDRESSABLE 
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NOT ADDRESSABLE 
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10 


NOT ADDRESSABLE 
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10 


NOT ADDRESSABLE 
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10 


NOT ADDRESSABLE 
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10 
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OlASOO 




10 


NOT ADDRESSABLE 
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10 


NOT ADDRESSABLE 
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10 


NOT ADDRESSABLE 










10 


NOT ADDRESSABLE 










01C800 




10 


NOT ADDRESSABLE 








• 


010000 




10 


NOT ADDRESSABLE 










010800 




10 


NOT ADDRESSABLE 










OlEOOO 




10 


NOT ADDRESSABLE 








• 


01E800 




20 


NOT ADDRESSABLE 










r OlFOOO 




20 


NOT ADDRESSABLE 








0IF800 




20 


NOT ADDRESSABLE 


^^^^22 










■1 


IHUHIHHI 







o 



Figured part 16 of 20 

A.26 Appendixes. 



Appendix G 

EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



o 





■■1 


033000 


■■■ 


00 


NOT 


ADDRESSABLE 


^^KKM 






033B00 




00 


NOT 


ADDRESSABLE 
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NOT 
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00 


NOT 


ADDRESSABLE 
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00 
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ADDRESSABLE 
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00 
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ADDRESSABLE 




9 oe<yy>taMA 3 


smu 


036800 




00 


NOT 


ADDRESSABLE 1/ 


- /l 




037000 




00 
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ADDRESSABLE 
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00 
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ADDRESSABLE 
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00 


NOT 


ADDRESSABLE 










038800 




00 


NOT 


ADDRESSABLE 
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00 


NOT 


ADDRESSABLE 
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00 


NOT 


ADDRESSABLE 










03A000 




00 


NOT 


ADDRESSABLE 










03A800 




00 


NOT 


ADDRESSABLE 










03B000 




00 


NOT 


ADDRESSABLE 










03B800 




00 


NOT 


ADDRESSABLE 










03C000 




00 


NOT 


ADDRESSABLE 










03C800 




00 


NOT 


ADDRESSABLE 










03D000 




00 


NOT 


ADDRESSABLE 
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030800 


00 


CHANGED > 
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O3F000 


O3E0O0 
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03F0O0 


00 
00 
00 
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CHANGED ) ^WU t^<fn of 
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• ADOR.OF ST PT ENTRIES PT ORIGIN ADDR 
00E650 32 00E430 




VIRT.AOOR 
040000 


REAL AODR 
020800 


KEY 
10 


STATUS 
CHANGED 




1 


^ 








040800 


019800 


10 


CHANGED 










041000 


017800 


10 


CHANGED 










041800 


018000 


10 


CHANGED 










042000 


018800 


10 


CHANGED 










042800 




10 


NOT 


USED 










043000 




10 


NOT 


USED 










043800 




10 


NOT 


USED 










044000 




10 


NOT 


USED 




A S ea.»te»/c' f' 






044800 




10 


NOT 


USED 








045000 




10 


NOT 


USED 
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NOT 


USED 
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10 


NOT 
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046800 




10 
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10 


NOT 


USED 








047800 




10 


NOT 
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10 


NOT 


USED 










048800 




10 


NOT 


USED 










049000 




10 


NOT 


USED 










049800 




10 


NOT 


USED 
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10 


NOT 


USED 










04A800 




10 


NOT 


USED 










04B000 




10 


NOT 


USED 










04B800 




10 


NOT 


USED 










04C000 




10 


NOT 


USED 










04C800 




10 


NOT 


USED 










O4DO00 




10 


NOT 


USED 










040800 




10 


NOT 


USED 










04EOOO 




10 


NOT 


USED 
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10 
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*** SEGMENT TABLE •»* 


^■i 




**♦ 


PAGE TABLE *♦* 




V rz 






/ STATUS / 
/ CHANGED 




ADDR.OF ST PT ENTRIES PT ORIGIN AOOR 
P0E668 32 00E5B0 




VIRT.ADDR 
OAOOOO 


REAL AOOR KEY 
028800 40 ~) 






t 






FZ"^ 


0AO80O 


028000 40 C 


J CHANGED 










OAIOOO 


02A8O0 40 [ 


UNCHANGED 












. 


0A1800 


02B000 40 J 
SO 


UNCHANGED 
NOT USED 






\ 


I 


0A2000 










0A2800 


50 


NOT USED 














0A3000 


50 


NOT USED 














0A3800 


50 


NOT USED 














0A4000 


50 


NOT USED 














0A4800 


50 


NOT USED 














0A5000 


50 


NOT USED 














0A5800 


50 


NOT USED 














0A6000 


50 


NOT USED 








'Se^yn^ 'fO 






0A6800 


50 


NOT USED 












0A7000 


50 


NOT USED 








V 






0A78OO 


50 


NOT USED 






3 








0A8000 


50 


NOT USED 






Ow 








0A8800 


50 


NOT USED 














0A9000 


50 


NOT USED 














OA9800 


50 


NOT USED 














OAAOOO 


50 


NOT USED 














0A6S00 


50 


NOT USED 














OABOOO 


50 


NOT USED 














0AB800 


50 


NOT USED 














OACOOO 


50 


NOT USED 














0AC800 


50 


NOT USED 














OADOOO 


50 


NOT USED 














0AD800 


50 


NOT USED 














OAEOOO 


50 


NOT USED 














OAE800 


50 


NOT USED 














OAFOOO 


50 


NOT USED 














OAF800 


50 

/ 


NOT USED 






« 




Fi 


'K 














*** SEGMENT TABLE *♦* 






♦*♦ 


PAGE TABLE ♦♦* 










ADOR.OF ST PT ENTRIES PT ORIGIN AODR 






VIRT.ADDR 


REAL ADDR KEY 


STATUS 








00E65C 32 00E5F0 






OBOOOO 
0B0800 
OBIOOO 
0B1800 
0B2000 
OB2800 
0B3000 
0B3800 
0B4000 
0B4800 
OB5000 


50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 


NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 








5 e^^rrte^tc / / 






0BS800 


50 


NOT USED 












0B6000 


50 


NOT USED 












0B6800 


50 


NOT USED 














0B7000 


50 


NOT USED 














0B7800 


50 


NOT USED 














0B8O00 


50 


NOT USED 














0B8800 


50 


NOT USED 














OB9000 


50 


NOT USED 














OB9800 


50 


NOT USED 














OBAOOO 


50 


NOT USED 














0BA800 


50 


NOT USED 














OBBOOO 


50 


NOT USED 














0BB800 


50 


NOT USED 














OBCOOO 


SO 


NOT USED 














OBC800 


50 


NOT USED 














OBOOOO 


50 


NOT USED 














0BD800 


50 


NOT USED 














OBEOOO 


50 


NOT USED 






9 








0BE800 


50 


NOT USED 














OBFOOO 


50 


NOT USED 








^^„^,^^,^^,,,,,^^^^._ * ■ . . ■ 
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f 
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50 


NOT USED 
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♦** PAGE FRAME 


TABLE *•• 




•* 


PFT EXT 


** 


■ 











-FLAGS 














^^k 




AO0R.OF PFT 


FIX CNT 


NFF 


OR 


SP 


NF 


FORWARO-PTR 


BACKHARO-PTR 


PAGE NR 


ADDR.OF PAGE 


PFIX CNT 




^^1 




. 000E88 


00000 

















000 


000000 


000 




^^1 




• 000E90 


00000 

















001 


000800 


000 




^^1 




000E98 


00000 

















002 


OOIOOO 


000 




^^1 




^ OODEAO 


00000 

















003 


001800 


000 




^^1 




• 0OOEA8 


00000 

















004 


002000 


000 




^^1 




00OE8O 


00000 

















005 


002800 


000 




^^1 




— 000E88 


00000 

















006 


003000 


000 




^^1 




• OODECO 


00000 

















007 


003800 


000 




^^p 




00DEC8 


00000 

















008 


004000 


000 




^^^ 




_ OODEDO 


00000 

















009 


004800 


000 




^^1 




• OO0E08 


00000 

















010 


005000 


000 




^^H 




OOOEEO 


00000 

















Oil 


005800 


000 




^^H 




^ 00OEE8 


00000 

















012 


006000 


000 




^^H 




• OODEFO 


00000 

















013 


006800 


000 




^^H 




00DEF8 


00000 

















014 


007000 


000 




^^B 




^ OOOFOO 


00000 

















015 


007800 


000 




^^H 




• 000F08 


00000 

















016 


008000 


000 




^^1 




OODFIO 


00000 

















017 


008800 


000 




^^1 




_ 00DF18 


00000 

















018 


009000 


000 




^^1 




• 00DF2O 


00000 

















019 


009800 


000 




^^H 




000F28 


00000 

















020 


OOAOOO 


000 




^^^ 




_ 00 OF 30 


00000 

















021 


OOA800 


000 




^^1 




• 00DF38 


00000 

















022 


OOBOOO 


000 




^^H 




000F40 


00000 

















023 


0OB80O 


000 




^^H 




^ 000F*8 


00000 

















024 


OOCOOO 


000 




^^1 




• 00DF50 


00000 

















025 


0OC80O 


000 




^^1 




00DF58 


00000 

















026 


OODOOO 


000 




^^1 




_ 00DF60 


00000 

















027 


0OD80O 


000 




^^B 




• 000F58 


00000 

















028 


OOEOOO 


000 




^^1 




00DF70 


00000 

















029 


OOE800 


000 




^^1 




_ 00DF78 


00000 

















030 


OOFOOO 


000 




^^1 




• OODFBO 


00000 

















031 


OOF80O 


000 




^^1 




O00F88 


00000 

















032 


010000 


000 




^^1 




^ 00DF90 


00000 

















033 


010800 


000 




^^p 




• 000F98 


00000 

















034 


OllOOO 


000 




^^H 




OODFAO 


00000 

















035 


011800 


000 




^^1 




^ 00DFA8 

~ OODFBO 

000FB8 


00000 
00000 
00000 























036 
037 
038 


012000 
012600 
013000 


000 
000 
000 


la^ fra>fnJL cU aa44^yy> 


1 




^ OODFCO 


00000 

















039 


013800 


000 




^^H 




• 000FC8 
OODFDO 


00000 
00000 




















040 
041 


014000 
014800 


000 
000 


^ O 1 O i,nM iK-e^jit£e/ 


■ 




_ 000FD8 


00000 

















042 


015000 


000 


OU, /k^ /3 2 hf^-KA 


^^H 




• OOOFEO 
00DFE8 


00000 
00000 




















043 
044 


015800 
016000 


000 
000 


H 




_ OODFFO 
• 00DFF8 


00000 
00000 
















00E068 


0OE2B8 


045 
UNUSED 


016BOO 


000 
000 


Aot^ « t/ir^^^ (xc^a^e^i 


H 




OOEOOO 


00001 

















130 


041000 


000 




^^H 




. O0EO06 


00001 
00000 

















OOE090 


OOEOCB 


131 
(-132) 


041800 

04209!?) 


000 
000 


o^ ^Z,O0O 


H 


• COOEOia) 




00E018 


00000 














00E078 


00E128 


315 


09D800 


000 


1 


^^H 




3_ 00E020 


00000 














OOE12 8 


OOEOFO 


129 


040800 


000 




^^1 




a* 00E028 


00000 














O0EO98 


00E068 


UNUSED 




000 




^^1 




00E030 


00000 














00E0D8 


00E048 


197 


062800 


000 




^^1 




_ 00E038 


00000 














00E070 


OOEOAO 


310 


098000 


000 




^^H 




• 00E040 


00000 














OOE048 


00E2A0 


199 


063800 


000 




1 














*** PAGE FRAME 


TABLE *** 




** 


PFT EXT 


•• 


1 











-FLAGS- 

















^H 




ADOR.OF PFT 


FIX CNT 


NFF 


DR 


SP 


NF 


FORHARD-PTR 


BACKWARD-PTR 


PAGE NR 


ADDR.OF PAGE 


PFIX CNT 




^^H 




_ OOE048 


00000 














00E030 


00E040 


198 


063000 


000 




^^1 




• 0OEO50 


00001 








1 









194 


061000 


000 




^^H 




00E058 


00000 














O0E2AO 


00E060 


195 


061800 


000 




^^1 




00E06O 


00000 














00E058 


OOE090 


196 


062000 


000 




^^1 




• 00E068 


00000 














00E028 


00DFF8 


UNUSED 




000 




^^1 




00E070 


00000 














OOEOFO 


00E038 


311 


09B800 


000 




^^1 




_ 00E078 


00000 














OOE080 


00E018 


312 


O9CO0O 


000 




^^H 




• 00EO80 


00000 














00E088 


00E078 


313 


09C800 


000 




^^1 




00E088 


00000 














OOEOBO 


OOEOBO 


314 


090000 


000 




^^1 




_ 00E090 


00000 














00E060 


OOEOIO 


128 


040000 


000 




^^H 




• 00E098 


00000 














00E140 


OOE028 


UNUSED 




000 




^^H 




OOEOAO 


00000 














00E038 


0OE138 


305 


098800 


000 




^^B 




_ 00E0A8 


00000 














OOEOOO 


00E120 


281 


osceoo 


000 




^^1 




• OOEOBO 


00000 














00E118 


00E088 


274 


089000 


000 




^^1 




00E0B8 


00000 














OOEOEO 


00E008 


277 


08A800 


000 




^^1 




_ OOEOCO 


00000 














00E298 


00E118 


275 


089800 


000 




^^1 




• O0E0C8 


00000 














OOEOIO 


OOEOOO 


279 


08B800 


000 




^^1 




OOEOOO 


00000 














00E0C8 


O0E0A8 


280 


O8CO00 


000 




^^1 




^ 00E008 


00000 














00E0B8 


0OE03O 


276 


08A00O 


000 




^^1 




• OOEOEO 


00000 














00E120 


00E0B8 


278 


08BO0O 


000 




^^1 




00E0E8 


00000 














00E0F8 


00E298 


319 


09F800 


000 




^^1 




^ OOEOFO 


00000 














00E020 


00EO7O 


309 


09A800 


000 




^^1 




• 00 EOF 8 


00000 














OOEIOO 


00E0E8 


318 


09F000 


000 




^^1 




OOEIOO 


00000 














O0E108 


00E0F8 


317 


09E800 


000 




^^1 




^ 00E108 


00000 














OOEllO 


OOEIOO 


321 


0A0800 


000 




^^1 




• OOElld 


00000 














00E130 


00E108 


320 


OAOOOO 


000 




^^1 




^^^^^JOEU^^^^ 


00000 














^OOEOC^^ 


^OOEOB^^^ 


316 


09EOOO 


000 


^^^^^^^^^^^^^mitr 


^^1 




HHHHIi 


■i 


■ 


■ 


■ 


I 


■■■ 


m 










1 



Figured part 19 of 20 
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EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



m lh 




,Y" '^N 



^ 



Figured part 20 of 20 
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Appendix H 

... ,. , , , TABLES USED BY 

Job Account.ng Interface j^g ACCOUNTING 

The Job Accounting Interface provides job step and job information that you can 
use for charging system use, supervising system operation, planning new applica- 
tions, etc. 

The job accounting option is supported when JA=YES in the FOPT supervisor 
generation macro. When this option is supported, the following tables are 
generated: 

• A job accounting interface partition table for each partition 

• A job accounting common table. 

Both tables are generated as part of the supervisor. 

The interface table is part of the partition table and provides user access to the 
job accounting routines and information. 

For each job step the following information is accumulated in this table: 

Job name 

User information 

Partition ID 

Cancel code 

Record type 

Date 

Job start time 

Phasename (from EXEC card) 

Highest address used (from communications region) 

CPU time 

Overhead time 

Stop time (at EOJ only) 

All bound time 

SIO count (optional). 
Note: If the CPU is not equipped with a timer, time fields are zero. 

To utilize this information, you must link-edit a routine to be relocatable by using 
the relocating loader option (or write a self-relocating routine) to store or print 
the desired portions of the table. This routine must be catalogued in the core image 
Ubrary under the name ^JOBACCT. 

How to locate 

The address of the interface partition table is contained in bytes X'74'— X'77' of 
the partition communication region. 

The address of the common table is contained in bytes X'7C'-X'7F' of 
SYSCOM. 
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TABLES USED BY 
JOB ACCOUNTING 



This part of the 
table is for 
user reference 



< 





Displacement 


Label 


Description 






(ACCTABLE) 






-3 


ACCTWK1 


Work area used in SIO update 




4 -7 


ACCTWK2 


Work area used with ACCTWK1 in start/stop time routine 




8 -11 


ACCTSVPT 


Job card pointer; address of job card field following jobname 




12 


ACCTPART 


ID of partition in charge (partition switch name) 




13 


ACCTRES2 


Reserved 




14-15 


ACCTLEN 


Length of SIO area = 6n+1 , where n = number of devices for this 
partition in SYSGEN option JA = n1 , n2, n3, n4, n5) 




16-21 


ACCTLOAD 


Label area instruction; moves JAI label area address to OPEN/CLOSE 
transients 




22-23 


ACCTRES3 


Reserved 




24-27 


ACCTLADD 


Address of alternate label area 




28-31 


ACCTPUT 


Counter for CPU time elapsed in a jobstep, counted in SOOths 
of a second 




32-35 


ACCTOVHT 


Counter for overhead time: time not charged to any partition 




36-39 


ACCTBNDT 


Counter for all-bound time: system wait state time divided between 
running partitions 


f 


40-47 


ACCTSVJN 


Save area for job name during simulated EOJ 


48-55 


ACCTJBNM 


Job name; taken from job card 




56-71 


ACCTUSRS 


User information 1 6 bytes from job card 




72-73 


ACCTPTID 


Partition ID: 'EG', 'F4', 'F3', 'F2'or 'F1'in EBCDIC format 




74 


ACCTCNCL 


Cancel code; see Cancel Codes and Messages 




75 


ACCTYPER 


Type of record: 'S' = job step, 'L' = last step of job 




76-83 


ACCTDATE 


Date in format specified at SYSGEN (MM/DD/YY or DD/MM/YY) 




84-87 


ACCTSTRT 


Start time of job, in packed decimal (DHHMMSSF; F = sign) 




88-91 


ACCTSTOP 


Stop time of job, in same format as ACCTSTRT 




92-95 


ACCTRES 


Reserved 




96-103 


ACCTEXEC 


Phase name taken from execute card 




104-107 


ACCTHICR 


End address of active program phase, from COMREG 




108-111 


ACCTIMES 


CPU time elapsed in a job step counted in 300th of a second 




112-115 





Overhead tinie: elapsed time not charged to any partition, in 300ths 
of a second 




116-119 




All-bound time: system wait state time divided between running 
partitions, in SOOths of a sec. 




120 


ACCTSIOS 


SIO tables: 6 bytes for each device specified by SYSGEN options, 
as follows: 2 bytes for device address (Ocuu), 4 bytes for count of 
SIOs in current jobstep. 


^ 






Overflow byte: normally X'20', but is X'30' if more devices are used 
within a partition than specified by SYSGEN options 



Notes: 



DSECT ACCTABLE symbolically addresses the JAI Partition Tables with labels as shown. Each 
partition in which JAI is supported has its own JAI Partition Table, labeled ACCTBG, ACCTF4, 
ACCTF3, ACCTF2 and ACCTF1 for active partitions BG, F4, F3, F2,and F1 respectively. 
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Figure H-1 . Explanation of the contents of the Job Accounting Interface partition table. 
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Displacement 


Label 


Description 




(ACCTCOMN) 




0-15 


ACCTSVRG 


Temporary register save area 


16-17 


ACCTSVRX 


Save area for remainder of overhead counter times 
distributed by partition on exit 


18-19 


ACCTSVRE 


Save area for remainder of all-bound counter times 
distributed by partitions on entry 


20-23 


ACCTPCNT 


Count of partitions using the Job Accounting interface 


24 


ACCTSAID 


Owner of physical transient area *) 


25 


ACCTFAID 


Interrupted program *) 


26 


ACCTRAID 


Active program *) 


27 


ACCTSWCH 


Accounting switches: if bit = 1, true; if bit = 0, not true 
bit 0: cancel accounting bit 4: IPL indicator 
bit 1 : no active partitions bit 5: not used 
bit 2: catalog in process bit 6: not used 
bit 3: alternate label area bit 7: not used 


28-31 


ACCTIME 


Start time of current accounting interval, in complement 
format 


32-33 


ACCTRESC 


Reserved 


34-35 


ACCTUSEP 


Address of user save area (ACCTUSER) 


36-37 


ACCTUSEL 


Length of user save area (Set with 1st operand of FOPT 
macro parameter JALIOCS) 


38-39 


ACCTSJOB 


Job accounting partition indication 


40-43 


ACCTBLES 


Address of BG Job Accounting Table 



TABLES USED BY 
JOB ACCOUNTING 



#> 



If multiprogramming is supported, this table is to be extended with one of the 
following fields (depending on the number of supported partitions), otherwise the 
table ends here. 



44-47 Address of F1 Job Accounting Table 

48-51 ACCTSEAS Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



44-47 
48-51 
52-57 



44-47 
48-51 
52-55 
56-63 



44-47 
48-51 
52-55 
56-59 
60-69 



ACCTSEAS 



Address of F2 Job Accounting Table 

Address of F1 Job Accounting Tab|e 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F4 Job Accounting Table 

Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



*) These values are the same as the PI K values for the relevant tasks 

Figure H-2. Explanation of the contents of the Job Accounting common table. 



NPARTS = 2 



.NPARTS=3 



NPARTS = 4 



VnPARTS = 5 
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JOB ACCOUNTING 



Programming considerations 

The user program for processing the information entered by the supervisor in the 
Job Accounting Table must be cataloged and be self relocating with the name 
SJOBACCT in a core image library. For efficiency, an overlay structure should be 
avoided, and the length of the program should preferably not exceed one core 
image library block. 

Because SJOBACCT is called in at the end of each job step, it should perform only 
data gathering and recording, but not data reduction and formatting if additional 
system overhead is to be held to a minimum. Overhead depends largely upon the 
efficiency of SJOBACCT. The optional SIO accounting (JA=nl , n2, n3) also 
causes additional overhead, 

LIOCS uses registers 13-1 5. If SJOBACCT needs any of these registers after a 
LIOCS function has been performed, save and restore the desired registers 
(register 14 should always be saved when using LIOCS because it is necessary to 
return to job control via the instruction BR 14). Chapter 9 in this section describes 
the usage of the general registers by system control programming and job accounting 

If SJOBACCT uses LIOCS, it should save at least part of the DTF information 
(status switches, extent information, and pointers) in the user save area. If more 
than one DTF is used, information from each should be saved. The user save area 
may be used to save any type of information as well as to accumulate step to 
step statistics for end job accounting. This accumulation reduces the rate of 
scheduled output records caused by writing a step accounting record for each job 
step. The user save area is not accessed by system functions. Chapter 12 in this 
section describes the save areas and the system generation macro JALIOCS. 

If an error causes SJOBACCT to be canceled, SJOBACCT is not called again until 
the system is re-IPLed. "JOB ACCT" appears in the cancel message, and the 
problem program name appear in the EOJ message. The STXIT option may be 
used to pass a message informing the operator that an error occured in SJOBACCT 
rather than in the problem program. (A description of tables used by user exit 
routines can be found in Section 4 of this manual, Chapter 10.) The job in that 
partition is terminated and normal processing continues with the next job. 

Refer to DOS/ VS System Management Guide for details on writing job accounting 
routines. 



^4 J.' 
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Appendix J 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example, Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics. The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,N0TAPEJ'RINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3 : Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT,SUM,SUMTAPE,VOL 

/* 

A work tape is required because the VOL option is specified.The work tape will 
contain a sequential list of all volume serial numbers along with a 5-byte disk 
address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
respond ENf). If the operator chooses not to mount a work tape, he should respond 
CANCEL END. This causes the SUM and PRINT TES options to be canceled. Any 
other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 
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PROCESSING TAPE ERROR 
STATISTICS USING EREP 



Example 4: Update the TES history tape on SYS007 . Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
II EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 

/* 

First the TES history tape is updated: the message 

3E09A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error, 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 



Wy 




An example of the EREP TES print formats. 
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Note: This option of 
EREP is only applic- 
able to the Model 145 



Appendix K 

EXAMPLES OF THE 
SUM OPTION OF EREP 



Example 1 : The job control statements required for a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 2715 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 1 5 

/* 

The 2715 groups is summarized first 






Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009,X283' 

//TLBLEREPNEW 

//LBLTYPTAPE 

// EXEC EREP 

OPTION SELECT,TAPE 

DEVICE=2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 
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RJE I/O TRACE 

An I/O trace for an RJE line after SIGNON can be initiated by specifying YES 
to TRACE = in the PRMT macro. 



Up to 127 entries of 32 bytes each. 
The last entry is followed by a blank 
tine of 32 bytes. Thus, the last few 
entries can easily be located in a 
dunnp of the buffer 



Entries are made in a wraparound buffer in the phase IPW$$TM. The following 
information is recorded at every I/O interrupt from this terminal. 

32 bytes »4 




Trace entry 



The last line response sent or received 
from the terminal 

Sense information 



Last four bytes of data buffer 
(irKludes TP control characters) 



A data buffer with four records. 
(Number of records in a data 
buffer depends on type of terminal) 



The trace is to be used when RJE line errors occur or incorrect output is 
encountered which can be caused by the I/O operation. 



vy 



POWER/VS FILE DUMP PROGRAM 

This program enables any of the POWER/VS files (account, queue, data) to be 
dumped on a Hne printer assigned to SYSLST. An option is also provided to 
enable queue records and their associated track groups belonging to specific 
jobs to be dumped. 

How to Execute 

The program is requested by JCL commands entered either via SYSLOG or 
SYSIN, where SYSIN is assigned to a card reader. Before requesting ensure 
relevant assignments are made for the file to be dumped. 

Example Job Stream 

1 1 JOB name 

//ASSGN (SYSOOO for Account file) 

(SYSOOl for Queue file) 

(SYS002-6 for Data files) 
//EXEC IPW$$DD 



When the program is loaded successfully, the following message will be issued 
to SYSLOG: 

DUMP FUNCTION = 
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SERVICEABILITY AIDS 
FOR POWER/VS 



At this point one of the following options can be entered via SYSLOG: 

A (to specify the Account file) 

Q (to specify the Queue file)^ 

D (to specify the Data file) 

Jobname (jobnumber) (, queue) ^ 

EOJ (to enable cancelation of the program or selection of a new option) 






1 The complete data file will be dumped. 

2 This enables (a) queue record (s) belonging to a specific job in the RDR, LST, 
or PUN queue plus its associated track group (s) to be dumped. Job name 
may be 8 characters, job number may be 6 characters. For the 'queue ' 
option one of the following three entries can be specified: 

L, for LST queue (default) 
P, for PUN queue 
R, for RDR queue. 

After the dump is completed, the message 

DUMP FUNCTION = 

is issued to SYSLOG again to enable either a new option to be specified or the 
program to be terminated by the option EOJ. 

Format of Output 

For every 100 bytes, a block of four lines is printed. Line 1 contains the 
printable characters in those bytes; line 2 contains the zone-part of each byte; 
line 3 contains the numeric part of each byte; Une 4 contains a scale indicating 
the position of the bytes in the string. 



line 1 

line 2 

line 3 

line 4 



CHAR // JOB POWJOBOl 
ZON 664DDC4DDEDDCFF44444444444 
NUMR 11016 20 7661620100000000000 
01. . .5. . .10. . .15. . .20. . .25. 



DATE 8/19/74, 
4444CCEC4FF6FF6FF6 
00004135008119174B 
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ANALYZING A DUMP 

OF THE POWER 

PARTITION 



Examine the TIBTAB to determine which tasks are active and which are ready to receive control. 






(hex) 2C / 2F 38 




/ r Genefattoo option sf / (see Q ) 



TIBTAB 



Devjce control t0b\es, 
(DCTal 



-4 POim^r- 



Nowork task 



Operator communications task 



QFILE task 



DATAFIL 
tasks 



Private SSL task 



System SSL task 



ACCTFIL task 



Execution 
processor tasks 



Reader and 
writer tasks 



" to COREBLKS table (which consists of the DATABLKS and PROGBLKS 
tables) 



as many as disk volumes were specified in the NUMDDKS generation 
parameter 



only present if SLI=YES was specified 
V only present if ACCOUNT=YES was specified 

► one per POWER supported partition in specified priority sequence 

► as many as were specified in the MAXRW generation parameter 



Fotrmt of a TtSTAB entry:: 



TSB Task entry point 



Look up the associated TIB 



Pointer to TIB 
I I 



5 



1 



e 



X'QO" « t^ek j$ Jr»«fC^ve tf^ ts^k «x«sts for th» TJetAis «ii%tiV> 
X'OV = task IS active and either has control or is waiting for an I/O 

event to occur 
X'03' ^ tg«k is r«««Jy to re^etve cctfitreil whan 9ii t^sks of t^ighttf 

pttDoty cannot receive corarol 
X'05' =» un<t r^ta&t^ ftrror recovery procedure is m progrm 



o 



Figure K.l, part 3 of 9 
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Locate DCTs and analyze access queues: 



DEVICETB 



TIBTAB 



Private SSL DCT 



System SSL DCT 



ACCTFILDCT 



QFILE DCT 



DATAFILDCTs 



Unit-record and 
tape DCTs 



Pointer to 
QFILE DCT 



Pointer to 
CORESLKS 



TieTAB tabJe 



only present if SLI=YES and a private SSL is assigned 
only present if SLI=YES 

only present if ACCOUNT=YES 



y as many as disk volumes were specified in the NUMDDKS 
generation parameter 



. as many as disk volumes were specified in the MAXCCB 
generation parameter 



P 



1 



The following is an illustration of a DCT access queue with three TIBs waiting to do I/O to the same DCT: 

DQPRTB DQPTRC 

DCTforenJ/OcKrvtce f 



(hex) 00 




2F 30 



Figure K.l, part 4 of 9 
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ANALYZING A DUMP 

OF THE POWER 

PARTITION 

Except for the TIBs for reader and writer tasks, all TIBs are located in the POWER control blocks area of the 
POWER partition. The TIB for a reader or writer task is located in the program buffers (seeH) allocated 
to the task. ^^ 



TIBACTN 



TIBSTAT 



TIBCHARD 



mm 



(hex) 00 



ID 



IE 



IF 



21 






L 



Identifies the type of the associated task: 

$0P = operator communication task 

bpp = execution processor task for the indicated 
partition :see^n 

ppP = punch writer task for the pp partition 
ppR = reader task for the pp partition 
ppT = print writer task for the pp partition 

XXP = partition-independent punch writer task 
XXR = partition-independent reader task 
XXT = partition-independent print writer task 

where pp = partition identification; BG for background, 
Fl through F4 for foreground 1 through 4 

Indicates the action performed by the task when the 
error occurred: 

For an execution processor T^B: see ^J 

For a reader TIB: see |3 

For a print writer TIB: see U| 

For a punch writer TIB: see [Q] 

For the operator communication TIB: see ^j 

Indicates why the task gave up the CPU or, if it has 
control of the CPU, that the last I/O performed was 
completed: 

For an execution processor TIB: see ^J 

For a reader TIB: see Ql 

For a print writer TIB: see Q 

For a punch writer TIB: see Q 

For the operator communication TIB: see Q 



Figure K.l , part 5 of 9. 
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Execution processor TIB. To locate an execution processor TIB see 



Input fronn SYSRDR: 



(hex) 00 



TIBRDRA 




TIBRDRB2 



First (or only) data buffer for input 
fronn SYSRDR. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



74 



t t 



77 






Second data buffer (if used) for input 
from SYSRDR. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



Output to SYSLST: 

TIBPRINT 



(hex) 00 



TIBPRNTA 



TIBPRTB2 




First (or only) data buffer for output 
to SYSLST. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



I 






Second data buffer (if used) for 
output to SYSLST. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



Output to SYSPCH; 

TIBPUNCH 



TIBPNCHA 



TIBPUNB2 




First (or only) data buffer for output 
to SYSPCH. Size of buffer depends 
on value specified in the POWER 
generation parameter DBLK. 



t t 



Figure K.l, part 6 of 9. 
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DF 



I size I = I size I 

1 I 



Second data buffer (if used) for 
output to SYSPCH. Size of buffer 
depends on value specified in the 
POWER generation parameter DBLK. 



■~>' 



.y 



Pageof GC33-S380-1, 
revised June 30, 1974, 
by TNLSN33-8780 



I Ql TIBSTAT of an execution processor TIB: 



Bit Meaning 

1 = SYSLST output for the current job entry will not be 

intercepted. 

1 reserved. 

2 1 = SYSPCH output for the current job entry will not be 

intercepted. 

3 1 = end-of-job processing for the current job entry takes place. 

4 1 = printed output is being intercepted. 

5 reserved. 

6 1 = punched output is being intercepted. 

7 1 = a job is being executed. 



Appendix K 

ANALYZING A DUMP 

OF THE POWER 

PARTITION 



UJI TIBSTAT of a reader TIB: 

Bit Meaning 

© 
1 
2 
3 
4 
5 
6 
7 



1 = task is going to be terminated. 

reserved. 

1 = Sequence of DISKETTE volumes is to be checked. 

reserved. 

1 = task is reading from a 3450. 

1 = both a card reader and a 3540 are assigned. 

reserved. 

1 = task is to be cancelled. 



TIBSTAT of a print writer TIB: 






Bit 

0-1 



Meaning 

1Q) = a stop command has been issued for the task. 

01 = a flush command for the current job has been issued for 

the task. 
11 = a restart command for the current job has been issued 

for the task. 
1 = a flush all command has been issued for the task. 
1 = the writer has completed output for the current job. 
1 = restart command directs the task to start from the 

beginning of the current job. 
reserved, 
1 = indicates to a tape writer that job separator pages are 

required. 
1 = a cancel command has been issued for the task 



Figure K.l, part 7 of 9. 
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UJ TIBSTAT of a punch writer TIB: 
Bit Meaning 

1 = a stop command has been issued for the task. 

1 1 = a flush command for the current job has been issued for the 

task. 

2 1 = a flush ail command has been issued for the task. 

3 1 = the writer has completed output for the current job. 
4-6 reserved. 

7 1 = a cancel command has been issued for the task. 

Wm TIBSTAT of the operator communications task TIB: 

Bit Meaning 

0-6 Reserved. 

7 POWER command is entered while a previous command is being 

executed. 

iq TIBACTN of an execution processor TIB: 

XW = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the contents of a print or punch buffer are to be printed or punched, 

respectively. 
X't)8' = a POWER EOJ card is to be processed. 
X'0C' = an input card is to be read. 
X'10' = a PRT card is to be processed. 
X'14' = a PUN card is to be processed. 
X'18' = a message is being written on the console. 
X'1 C = either a JOB card (writer-only system) or an SLI card (reader system) is to be 

/processed. 
X'20' = a card from the Source Statement library is to be processed. 

Q TIBACTN of a reader or writer TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = the task waits for work. This code is set by the execution processor for the 
same partition: 

— for a reader task when all card input for a job is complete 

— for a writer task when all print (or punch) output for a job is complete. 
X'08' = The task waits for completion of 

— a read operation on the associated card reader if a reader task. 

— a print operation on the associated printer if a print writer task. 

— a punch operation on the associated card punch if a punch writer task, 
X'1 8' — The task has issued a message to the console and waits for completion of the 

typing operation. 

Ill TIBACTN of the operator communication TIB: 

X'00' = disk I/O was in progress or just completed if the task was in control of the CPU. 
X'04' = The task is inactive, that is, all commands have been processed. 
X'08' = the task has received a command and has initiated processing of same. 
X'10' = I/O for the ACCTFIL is in progress. 

X'18' = the task has initialized writing a message on the console and waits for completion 
of the typing operation. 



\_. 



Note: For POWER start up, the TIBACTN code has been assembled as X'd 
associated TIBTAB entry has been assembled at X'03'. 



V and the TSB of the 



Figure K.l, part 8 of 9. 
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OOS/VS pafttt«jn save drea 



Operator comrnunicatKjn 
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PARTITION 

Locate the program and data buffers by means of 
pointers in the parameter list table and in the PROGBLKS 
andDATABLKS tables: 



COMMONDT 



POWER control blocks 



I Parameter }^st tg^bte / / 
(hex) 00 



48 



4B 4C 



4F 



□-□ 



Execution proco^sof cocJ^ ^nti 
ctMrtmon subroutines 



Supervisar-st^te ciode 



^,-— — "" 


yt^' 




PROGBLKS 


SB 


Pointer to program buffer 




SB 


Pointer to program buffer 


p 


: 




SB 


Pointer to program buffer 



L 



SB = Status byte: 

X'OO' = buffer not used 
X'03' = buffer used or 
no buffer exists 



Program buffers 



d 



Data buffers 



DATABLKS 


SB 


Pointer to data buffer 


', 


' 


' 




SB 


Pointer to data buffer 



Program buffers are generated only for reader and writer tasks. The number of program buffers generated 
is equal to the number specified in the MAXRW generation parameter. The format of a program 
buffer as shown below in the illustration on the left. The illustration on the right shows that two program 
buffers are acquired by a reader task using the 3540 as input reader. 



IK 
bytes 



\j) 



TIB for task (see Q ) 



Phase entry and exit code 
(identical for all phases 
of a task) 



Phase code 



FGPSPOLx 



2K 

bytes 



Name of phase executing 
in the buffer, where 
X = phase identifier. 
The name's address is: 
A(TIB)+X'400'-8 



Figure K.1, part 9 of 9. 



TIB for task (seeQ) 



Phase entry and exit code 
(identical for all phases 
of the task) 



Phase code 



FGPSPOLx 



3540 control block 



Name of phase executing in" 
the buffer, where 
X = phase identifier. 

In a dump, the translated 
phase name can be used to 
locate the 3540 control 
block. 



> 
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The method of locating POWER/RJE control blocks and areas is shown in a series 
of illustrations in Figure L.l, parts 1 through 14. Notes within this figure provide 
information that will help you in determining the status a POWER/RJE task had 
at the time the dump was taken and in analyzing the contents of specific areas or 
bytes. 

The table below assumes that you have successfully located the POWER partition 
either (1) by tracing its beginning from the pointer in the active partition to the 
partition's save area or (2) by locating in the translated dump column the name you 
have used for the generation macro at the time of POWER/RJE assembly. 

The table does not include the steps that must be taken in order to locate normal 
POWER control blocks, such as an execution processor TIB or a reader or writer 
TIB, nor does it include information about how to analyze these POWER control 
blocks. For this information refer to Appendix K or the DOS/VS POWER Program 
Logic Manual. 

The reference table below is provided as a help in locating the information which 
you need to find a specific block or area in a dump. In the illustration, always look 
for the given reference to the left of text. 



Block or area to be located 


Reference to the Illustrations 


CCB (in DTFBT) 


M 


DTFBT 


M 


DECB (data event control block) 


J 


Generation options table 


D 


Parameter list table 


D 


RJEBLK (RJE block) 


H 


RJBLKLST (RJE block name list) 


K 


RJE TIB (RJE task information block) 


G 


RJLIST (RJE active task list) 


F 


RJUSERS (RJE list of authorized users) 


L 


TIBTAB (task information block table) 


D 
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If the POWER/ RJE program was assembled with a unique name for the 
generation macro you can look up that name in the left of the translated 
dump columns. 
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A 1 K area used for the execution of the operator communication 
transient phases. The last eight bytes contain the name of the phase 
that has been executing in the area. This name has the format 

FGPTYPxx 

where xx = phase identifiers 

The address of the name is: 

I X'78' I 
A (partition save area) +\ y-co- ( + X'400'-8 



* FESERVNO 156014 * D OS/ VS POWER v.d,M.d 



(hex) 14 



■o- 



Generation Option table 



2B 2C 



^ 



fff V.d. = program version number 

M.d. = program modification number 

Locating this constant in the translated dun)p columns is a quick 
method of locating the beginning of the POWER/ RJE control 
blocks area. 



xxxxxxxx 



? 



DOS/VS partition save 
area 



Operator communication 
transient area 



FGPTYPxx 



mm^mm 



liiiiiiiii^iiiijjm 



liiiiiiiiiiiiil 



User ID list 
(RJUSERS) 



POWER/RJE control 
blocks 



! 



Execution p<0ees$or 



. ^i^pervieof-s^id: <octe 



PtTngrarA bidS^rs 



, l» M I« HM I WM I H WW<4*W M W* M * M > » t »» *Piiii 

Data btiffQira 



(hex) 2CJ 2F 30 / 33 34 




Generation options 



la 



3D 



^ Analyze both the generation option switch and the options in the table. 
For details, see ^ 



I y*araimi6Kftf ^^ tabte | gw u 



GENsw iiilii 



Figure L.l, part 1 of 14 



^ For full details about the fields of the table, see the "Data Area" section. 
For important switches, see ^ 
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\. 



J"' 



lil continued 



O 



Generation option table 



(hex) 2C 

t 

from beginning 
of FGPSPOOL 
CSECT (resident 
POWER code) 



mmmmrmrimrmm 



(hex) 00 



34 



*t- 



37 38 39 3A 3B 3C 3D 



p 



L 



1^ niimbw of CCB'ft th«t imn be ua^ for Mm 
wejjimMw w»¥«W of <*ata Iwffw^ that the I'^OWCI^ . 

maximum number of RJE tasks that can be started at 
one time (MAXRJS) 

mdximum number of (ieaders snA WFtters that can be 

t^Mt^^r ^f DATAI^Ii ciiSck^ aSpwed (MUMODKSl 
ri«nf^>9r of tr«5k$ » ?'tr*?Jt §rp<»p CffiAC«OP} 



t^tmnvlfff B&t tal:^ 



31 



GENSW 
I 



s 



130 131 



8iillii^iii:iiiiii|iiii^ 
iiiiliii!liiiiiilM;|g^ 

3 RJE is inciuded (MAXRJS=1 to 5 was specified) 

4 JOBSEP* YES vwas specm^d 

5 RPS support 

6 JOeSEP=^YES Vi^s specified 

7 0542^'=^ YES 

liiiiiNiiiSiiiiHiB 

iiiiiliiBiBiiiiiiiB 

4 RJE=YES was specified 

iiiiiiiiiiliiiiiiiiil^lH 
iiiiiiiiiiiiiiiiiiiiiiiii 



v.. 



/#" 



^ 



Figure L.l, part 2 of 14 
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^ continued 



[ 






?/ i WM ^a 



(hex) 00 



1D4 



1F2 



L 



TYPEIN+X'1 E': indicates buffers obtained for RJE task 
initiation 

Bits Meaning if 1 

0-2 reserved 

3 BIM's turnaroud data buffer obtained 

4 BIM program buffers obtained 

5 task s data buffer obtained 

6 RJEBLK program buffer obtained 

7 RJE task program buffer obtained 

Note: These switches are used only by FGPTYPS1 
and FGPTYPS2 

PCPEIN: 

X'OO' s phase FGPTYPBO has finished executing 

X'FF' = an additional track group must be obtained 
for RJE messages, and the tracks of that 
group must be initialized as free message 
records. 

Note: This switch is used only by phases FGPTYPBO, 

FGTYPB1, and FGPTYPB2. 



Task ownership byte 




la 



(hex) 00 



60 61 



63 64 65 



67 



L 



address of the BIM simulator if the preceding byte 
is # X'OO' 

X'OO' = the BIM simulator is not in storage and the 

next three bytes are insignificant 
not X'(X)' = the BIM simulator is in storage 
(see Note below) 

address of BIM if the preceding byte is ^ X'OO' 

X'OO' s the BIM is not in storage and the next 

three bytes are insignificant 
not X'OO' = the BIM is in storage 



Figure L.l, part 3 of 14 



Note: Each time a task requests the services of the BIM (or BIM simulator), 
the contents of the task ownership byte are shifted to the left by one bit 
position and bit 7 of the byte is set to 1 . Each time a task finished using 
the BIM (or BIM simulator), the contents of the task ownership byte are 
shifted to the right by one bit position and bit of the byte is set to 0. 
A copy of the byte's bit configuration for a specific task is contained in 
the RJBLKLST entry for that task (see Q ). 
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Generation options table 



2C 




33 34 



37 38 



TIBTAB 



,/Ok 



W (see Q and Q 







-OC 










1 


__ 














1 




1 




Nowork task | 




Op 


. communication task 






QFILE task | 




; 


DATAFIL 
tasks 


/ 


> 


Private SSL task 




System SSL task 


} 


ACCTFIL task 


) 




Execution 
processor 
tasks 




> 


5 


RJE tasks 
(up to five) 


f 




' 


Reader and 
writer tasks 


'. 





3D 



to QFILE DCT 



to RJLIST (see Q ) 
to COREBLKS table 



as many as disk volumes were specified in the 
NUMDDKS generation parameter 



only present if SLI=YES was specified 

only present if ACCOUNT=YES was specified 



one per POWER supported partition in specified 
priority sequence 






as many as were specified in the MAXRW 
generation parameter 



Format of a TJ$TA.B Wtry; 



1 



TSB 



Task entry point 



Address of TIB 
-J *■ 



-+• 



Look up the 
associated TIB 



L 



X'OO' » tas* '» fOBcSve \i\xx tssic €xi&ta fw th'» TrSTAB ftntry) 
•w- X'OV = task IS active and either has control or is waiting for an I/O event to occur 

X'63' « fesk \% r««dy to psx!,&m coi»tPo( vii^ft «|{ td^s of Ngh^f pm^ <jsnm*t reo^tvift c<jirt«itf 



Figure L.l, part 4 of 14 
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^ only if the task is active; set to F'O' otherwise 



RJLIST* 



-^ eight bytes ■ ^ 


Address of DEC a 


^7 
Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


Address of DECB 


Address of TIB 


X'FF' 


Reserved 


n 


Address of 2780 BIM | 


n 


Address of BIM SIM 


Address of RJBLKLST 


Address of RJUSERS 


Address of RJBTMOD 



X'FF' = indicates the end of the list 

* contains as many entries as RJE tasks were specified in the MAXR 
Figure L.l, part 5 of 14 



O 
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TIBTAB 



I R J LIST *y/ I ^ Register 7* | 



* only if the associated task is active 



I Dcuuxxxx RJE TIB / 



>/ 

L 



name of RJE block that contains the RJE TIB <for further details about the RJE block, see ||J ) 



cuu = line address at the central station 

xxxx = type of terminal used: 2770, 2780, or 3780 



tUJEtlg III TIBACTN 



TIBSTAT 



TIBCHARr> 



(hex) 



ID 

N .. /\- 



1E 1F 



21 



L 



Vy 



contains the characters RJE 



Bit Meaning if 1 

stop the task 

1 flush the TP input and write a message to the 
work station operator 

2 a TP input record is available (a TPIO READ 
cannot be issued) 

3 (only if a 2780 is used) the first record in the 
data buffers has a space-immediate CCW and 
is preceded by a print-no-space CCW as the 
last record of the buffer used previosly 

4-7 reserved 



X'CX)' = disk I/O was in progress or just completed if 

the task was in control of the CPU 
X'04' = the task waits for work 
X'07' = a TP READ INITIAL has been issued 
X'08' = a TlPO other than read initial has been issued 
X'18' = the task has issued a message to the console 
and waits for completion of the typing 
operation 



Figure L.l, part 6 of 14 

A.54 Appendixes. 



Appendix L 



ANALYZING A DUMP 

OF THE POWER RJE 

PARTITION 



^^„i^ 



continued 



ftvJE ttS 



11 



■TIBCODES (10 bytes) 






(hex) 



22 



26 



2B 



TIBCODES+4: indicates the transfer of control 
between the OUTPUT work station command 
processor, the print overlays and the punch overlays: 






X'16' 
X'18' 



X'lC = 



X'10' = print operations are in progress 

X'14' = punch operations are in progress or to be 
processed for an ALLUSERS request 
a punch job is to be placed in the hold state 
punched output is available for an 
ALLUSERS request or a jobname request if 
the JCT userid field is ALLUSERS 
the print overlays have transferred control 
directly to the punch overlays or punched 
output is available for userid for a jobname 
request 

X'30' = the punch overlays have transferred control 
directly to the print overlays or printed 
output is available for userid for a jobname 
request 

X'38' = printed output available for an ALLUSERS 
request or a jobname request if the JCT 
userid field is ALLUSERS 
a print job is to be placed in the hold state 
a print job is to be placed in local state for 
processing at a local output device 

X'70' = a print job is to be placed in local state for 
processing at a local output device 



X'50' 
X'60' 



TIBCODES (10 bytes) 






'"'!!?'% 



(hex) 



22 



28 



2B 



TIBCODES+6: contains the address of the next TP 
input record or the data portion for TP output (this 
field is altered only by the BIM) 



Figure L.l, part 7 of 14 
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continued 



J 



■TIBRDRWQ(4 bytes) 



aiETIS 






(hex) 



71 



72 



73 



Bit Meaning if 1 

■ 0-5 reserved 

6 termination of reader overlay has been requested 

7 reserved 



■ 0-3 reserved 

4 the first record read was a JOB statement 

5 end-of-file on TP 

6 request for a track group is to be forced 

7 no track group found 

■0-1 reserved 

2 a OOS/VS job card was read 

3 FGPPRJE4 was called by FGPPRJEY 

4 an EOJ JECL statement is being moved to the 
data block 

5 an input record is available ( a TPIO READ 
cannot be issued) 

6 the first record is in a disk buffer 

7 a JOB JECL statement was read (JECL must 
control Awhen the end of a job entry has been 
reached, not a DOS/VS /& statement). 



\_J 



HPii 



TIBRDRB2 



TIBRDMR 



(hex) 



74 



77 78 



7B 



pointer to next available F>osition for a logical record 
in the current data block 

-pointer to DECB used by the associated task 
(see n for details) 



Figure L.l, part 8 of 14 
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continued 



|n!ni!i!i!i>i!i(j;|i!Pi!i|i!i^^ 
liiiiiiiiiiiliiiiiiiiiijlin^ uiiiiiil 



•TIBPRINT (40 bytes) 



21 



(hex) 



80 81 83 84 



87 A7 






address of last BTAM I/O - used for retries 

address of 81 M being used 

C'R' = the task is in read mode 
C'W = the task is in write mode 

* X'OO' = the switched line is disconnected 

* X'02' = an EOT received (no line disconnect) 
*X'04' = intervention is required at the work station 

* X'40' = stop was requested when a TPIO macro 

was issued 

* X'80' = an irrecoverable error has taken place 
*X'81' = timeout has occurred at the work station 

and the user session is terminated 

* settings that arise from TP exceptions when the 
task's TP exception routine is entered 



c^^uc 



-* TIBPRINT (40 bytes) *H 



la 



li 



mmmmmmm 






(hex) 



80 



8C 



A7 



TIBPRINT+12. its bits are set by the TPCOMPL 
routine to indicate to the BiM that an exception has 
taken place: 
Bits Meaning if 1 

TPCOMPL has been entered 

1 an exception has taken place 

2 stop was requested since last TPIO was issued 
3-7 reserved 






Figure L.1, part 9 of 14 
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I "-^^^ / r 



■TIBPRINT (40 bytes) 



11 






(hex) 



80 



8D BE BF 



A7 



TIBPRINT +15 indicates input and TP buffer status: 
Bits Meaning if 1 

last block from DATAFIL was used to fill the 
TP I/O area 

1 input in TP I/O area was from a BTAM read 

2 last print block is in TP I/O area 

3 intervention required on print (EOT) 

4 the end of a data block was reached when the 

TP area was last filled with input stored on disk 

5 input in TP area is from the DATAFIL 
intermediate storage 

6 input is being transferred to a data block during 
TP read-to-write line turnaround 

7 input has been stored on the DATAFIL 

TIBPRINT+14 indicates the TPIO function 
requested when the BIM was last entered: 

X'02' = read 

X'04' = detach 

X'05' = punch 

X'06' = print 

X'07' = flush the input and write to the work station 

operator 
X'OB' = write to the work station operator 
X'09' = open the RJE task DTFBT 
X'OA' = close the RJE task DTFBT 

TIBPRINT-i-13 indicates line direction: 

X'OO' = line is not initialized or is in control mode 
X'Or = CPU is receiving 
X'02' = CPU is transmitting punch records 
X'04' = CPU is transmitting print records 
X'OB' = CPU is transmitting a message 



\ 



Figure L.l, part 10 of 14 
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* only if the associated task is active 



DECB (see El for details) 



I/O area 






DTFBT (see ^ for details) 



DcuuxxxxA 



(hex) 



(hex) 00 




Note: For full details about switches maintained by 
BTAM, see the manual DOS Basic Telecommunications 
Access Methods, GC27-6989 



Figure L.l, part 11 of 14 



pointer to RJLIST (see Q ) 

X'OO' = task does not operate in simulation mode 
X'OV = task operates in simulation mode 

pointer to the DTFBT (see uSl ) 

bit 1 is used to indicate the following: 

if = the task has control of the CPU or is waiting 

for a TP operation to complete 
if 1 = the task is ready to run 



Appendixes. A.59 



Appendix L 



ANALYZING A DUMP 
OF THE POWER RJE 
PARTITION 



continued 



,m^ / I 

(hex) 



PNTRJBLK 



PNTTERM 



PNTUSER 



DEVCHAR 



I 



lUlUtMMMMmttMiM 



(hex) 00 



2C 



2F 30 31. 33 34 37 38 3B. 



■ 



OD OF 



L 



pointer to userid entry (in RJUSERS) representing 
the user currently logged on (for the format of a 
userid entry, see Q ) 

pointer to userid entry ( in RJUSERS) representing 
the accepted termid in the last acknowledged 
RJSTART command 

pointer to the RJBLKLST (RJE block name list) entry 
used to initiate the task (for the format on an 
RJBLKLST entry, seeQj) 

work station status: 

X'OO' = inactive 

X'01' = attached, but no user logged on 

X'03' = attached and processing (user is logged on) 

pointer to task ownership mask in BIM pointer 
behind the RJ LIST (see Q) 



pointer to the I/O area 






I &ECB f p 



PNTRJBLK 



■^ifji^ii^^ii^^ij^jji^^ijfi^j^i^^ 



iffffS!!!!?!!!!?!?!?!!?? 



iyiM:':'! 



30 / 33 



[ 



RJ8 tKLST 



(hex) 00 



03 04 



07 08 



OF 



length of RJBLKLST 

number of entries (identical with number of RJE 
blocks) 



' 1 



iiiii ^ 



■first RJE block name entry- 



Block name | fteserviM 



(hex) 00 



10 



17 18 1B1C ID IF 



^ 



■7 bytes - 



i^ second and succeeding RJE block name entries 
Figure L.l, part 12 of 14 
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FF' = end of list 



pointer to DECB used by the associated RJE task 
(only valid if the preceding byte is ?t X'OO' ) 

task's BIM ownership mask 



I" 



y 
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PARTITION 




(hex) 00 



03 04 



07 08 



OF 



Entries in RJUSERS table 



X'40' 

length of RJUSERS 



C, 



1 ^r 



RJUSERS entry 



Userid or Termid 



(hex) 00 



10 



17 18 IB 1C IF 



S^ 



— — — 1 
fieserved | 



l: 



number of entries (three bytes) 
X'FF' = end of list 
pointer to second DECB, if used 
pointer to first DECB 



@ second and succeeding RJUSERS entries; each of 
these entries has the same length as the first one 



(hex) 09 / OC 




1 



(hex) 00 01 



[PTPWT i i First LCB (line control block)* ll ||i| * all LCBs of a system have the same length 
28 



length of an LCB 

number of LCBs contained in the DTFBT 



Figure L.l, part 13 of 14 
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/flK 



continued 



o 



{ mmt l l 



CCB (command control block) 



(hex) 00 



28 2A 2B 2C 



31 



37 



pointer to the first CCW in the channel program 
a copy of the CSW status bytes 

Bit Meaning if 1 

data check in count area (OASD) 

1 track overrun (DASD) 

2 end of cylinder (DASD) 

3 2540 equipment check 

4 questionable condition 

5 reserved 

6 carriage channel 9 or verify error for DASD 

7 reserved 

traffic (wait) bit 

1 flag bit 

2 unrecoverable I/O error 

3 acceptable unrecoverable I/O error 

4 return DASD data checks to user 

5 post at device end 

6 return DASD data checks on count, read 
command, or verify command 

7 user error routine exists 

residual count from the CSW 






Figure L.1, part 14 of 14 
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ANALYZING A DUMP OF 

THE POWER/POWER RJE 

QFILE 



Analyzing a QFI LE Dump 

A dump of the POWER disk file QFI LE can be very helpful if, for example, the POWER 
program failed because of a disk I/O error. Although analyzing the JCTs in the various queues 
may not isolate a problem, it may provide hints on how to define the problem still further. 
Figure M.I piarts 1 and 2 are provided to help you in analyzing a QFI LE dump. 






Byte 
(in hex) 





CC 
DO 



QFILE 
master record 



E8 




first JCT in print queue 
last JCT in print queue 
first JCT in punch queue 
last JCT in punch queue 
first JCT in reader queue 
last JCT in reader queue 
first JCT in purge queue 
last JCT in purge queue ^ 



There is one such set of pointers for each POWER supported 
partition. These sets of pointers are arranged in the same 
sequence as the supported partitions were specified in the 
POWPART parameter of the POWER generation macro. 



Note: For 3330/3333 MCHR means the following: 



Record number 




Halfword containing the displace- 
ment into the data block. 



Head number 

= Cylinder number is less then 256 

1 = Cylinder number is 256 or higher 
eight low-order bits of the cylinder number 

POWER system logical unit number 



Figure M.l, part 1 of 2 
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Structure of a hypothetical QFILE (only one queue is shown): 



M 



QFILE master record 



JCT I 



JCT 



JCT 



JCT 



JCT 



JCT 







1 



JCT 



r^ Layout of a QFILE nnaster record (for further details refer to Figure 5.3): 



L-j I \ ULIL 



f«- / / $e»w<i 



poihters 



(hex) 



2C 



CB CC 



^ If ACCOUNT=YES was specified for POWER generation, this field points to the next available ACCTFIL 
record; otherwise the field is set to zero. 



lH Layout of a JCT (for further details refer to Figure 4.4): 



I I I I I 



^ 



iri2j±nnc=} 



(hex) 



8 9 



OC OD OE 



20 21 22 23 



l^ 



J^ 



Q Contains the DOS/VS or POWER job name; if no job name was specified, the field contains the character 
string AUTONAME. 

^^ Contains the POWER assigned job number. 

^ Each of the bytes contains either CD' or C'H': 

D = dispatch (the job is ready for processing by the proper task) 
H = hold (the job is in the hold state) 

Byte OC: indicates the job's status in the reader queue. 
Byte OD: indicates the job's status in the printer queue. 
Byte OE: indicates the job's status in the punch queue. 

^ Identifies the associated partition: BG, F1, F2, F3, or F4. 
^k Contains the class of the job's print or punch output. 



Figure M.l, part 2 of 2 
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Appendix N 

ONLINE TERMINAL 

TEST FOR THE 

IBM 2780/2770 



The online terminal test for the IBM 2780 and 2770 is an optional service provided 
by BTAM. It is provided to ensure proper operation of the system, and it may be 
used in the diagnosis and correction of a terminal malfunction. BTAM recognizes 
Request-for-Test messages transmitted by the remote work station. When an RFT 
message is recognized, BTAM performs the requested test, which is usually 
transmission of a tewt message. 

The BSC online test facility recognizes Requcst-for-Test message only if: 

1. BSCTEST=YES is coded in the RJE/BTMOD macro. 

2. TERMTST=YES is coded in the RJEBLK macro that assembles the DTFBT. 

3. The operation is a Read Initial, 

4. The application program issued a TWAIT with TERM TST= YES following the 
macro instruction that was executing when the RFT was received. 

5. If a 2770 terminal: 

a. The ONLINE TEST button is pressed. 

6. The RFT message is received without error. 

Because BTAM only recognizes RFT messages on a Read Initial, the RFT card must 
be read within 28 seconds to be received without error. Failure to submit the card 
within 28 seconds requires the user to send an RJSTART and RJEND card. The 
RJE task must issue a Read Initial before any RFT cards will be accepted. The on- 
line test facihty is described in the DOS/VS Basic Telecommunications Access )d 
Method manual (GC27 -6989). 

The online test facihty prints the results of the test on the computer console. Two 
messages are provided; one is used when BTAM is transmitting test messages (or 
RFT messages with X=0), the other when BTAM is receiving test messages. The 
content of these messages is: 

Transmitter Receiver 

Line Address Line Address 

Number of Transmissions (Y) Number of Transmissions 

X Field X Field 

Time-outs Time-outs 

NAK's Received Lost Data Occurrences 

Terminal ID (multipoint) Data Checks 



Appendixes. A.65 



Appendix N 

ONLINETERMINAL 
TEST FOR THE 
IBM 2780/2770 



The formats of these messages are: 

for the transmitter: 

4B70I ON-LINE TEST cuu xx yy TO NK TI 

for the receiver: 

4B71I ON-LINE TEST cuu xx yy TO LD DC 

where: 

4B70I identifies the messages as BSC onUne test results for the transmitter. 

4B71I identifies the message as BSC online test results for the receiver. 

cuu specifies the line in the form channel and unit. 

XX specifies the test type. This is the X field from the RFT message. 

yy specifies the number of transmissions. For the transmitter, this value is the 
value from the RFT message. For the receiver, this value is accumulated by the 
onhne test program. If online test was not successfully initiated, this field will 
contain zero. 

TO specifies the number of time-out occurrences. 

NK specifies the number of NAK's received by the transmitter. 

TI for multipoint lines, specifies the terminal ID; for point-to-point lines, it is 
blank or specifies the component selection sequence received with the RFT. 

LD specifies the number of occurrences of lost data. 

DC specifies the number of occurrences of data check. 

The following onUne test procedures may be used for switched and leased-line 
IBM 2780s. 






'\^_j 
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ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 
2780 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the onUne test 
features option in. Do not try to run these tests if online test in the customer's 
program is not available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and the CE panel in the 
operate position. 

2. Turn the Mode switch on the 2780 operator console to the TRANSMIT 
position. 

3. Flip the Online Test Switch on the CE panel to the ON position. 

4. Place the RFT (request for test message) card into the hopper. 

5. Ready the printer. 

6. Depress the Serial Reader Punch Start key to begin the test. 

SOH %01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits the data back to the 2780 that was contained in cc 8-80 of the 
test message card. The CPU sends this message to the 2780 as many times as 
indicated by the punch in cc 5 and 6 of the test message card. 

Format is as follows: 

Col Punches Character 

Indicates this card is an RFT (request for test 
message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2780. Columns 1 1-79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2780 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 



1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 








4 


1 


1 


5 




Y 


6 




Y 


7 





0' 


8 


12-2-9 


STX 


9 


0-7-9 


ESC 


10 


0-1 




11 






80 


12-3-9 


ETX 
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SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2780 terminal. The 12 designation indicates which transmission code the 
2780 terminal has that is requesting the test (EBCDIC). 

Format is as follows: 



■"'i...y 



:oi 


Pur 


ich 


es 


Character 


1 


12- 


-1- 


-9 


SOH 


2 


0- 


4- 


8 


% 


3 








1 


4 








2 


5 








Y 


6 








Y 


7 












8 


12- 


-2- 


-9 


STX 


9 


12- 


-3- 


-9 


ETX 



Identifies this card as an RFT (request for test 
message) card. 

These columns designate a request for a 
stored message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program. 



The following message will print in the 2780 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



\^J 
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2780 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has onUne test option 
in. Do not try to run these tests if online test feature is not available. 2780 setup: 

1. If the 2780 has the AutoTurnaround feature, depress the AutoTurnaround 
switch to place the 2780 in AutoTurnaround mode. If the 2780 does not have 
AutoTurnaround, install the foUov^ing cards into the B gate: 
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Card Location 


6-Bit 


EBCDIC 


USASCII 


02B1B20 


None 


AJW (370643) 


None 


02B1C34 


DGV (370378) 


DHC (370372) 


DGV (370378) 


02B1C35 


DGT (370380) 


DGV (370378) 


DGT (370380) 


02B1C36 


DGU (370379) 


DGT (370380) 


DGT (370380) 


02B1C37 


DGV (370379) 


DGU (370379) 


DGV (370379) 


02B1C38 


DHC (370372) 


DHC (370372) 


DHC (370372) 


02B1C39 


AJW (370643) 


DHC (370372) 


None 



Note: The cards to be installed are the special test SMS cards included in the 2780 
shipping group. These cards must be removed before returning the 2780 to 
the customer. 

2. Place the Operate/Test switch on the 2780 data set cable and the CE panel into 
the operate position. 

3. Turn the Mode switch on the 2780 operator console to the transmit position. 

4. Flip the Online Test switch located on the CE panel to the ON position. 

5. Place the RFT (request for test message) card and a deck of blank cards into 
the hopper. 

6. Depress the Serial Reader Punch Start key to begin the test. 



o 



SOH %01 PUNCH TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2780 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2780 automatically reverts to punch 
mode because AutoTurnaround was activated, or because the CE test SMS cards 
were installed as described in step 1 . 



Format 


is as follows 


>: 


Col 


Punches 


Character 


1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 



1 


5 
6 




Y 
Y 


7 








8 
9 

10 
11 
80 


12-2-9 

0-7-9 

4 


STX 
ESC 

4 



Identifies this card as an RFT (request for 
test message) card. 

Indicates the type of test requested. 



Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back to 
the 2780. Any non-control characters can be 
punched in cc 1 1—80. 



o 



This test should operate to the 2780 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 
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SOH % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2780 terminal The 13 designation indicates which transmission code is to be 
used. The 2780 automatically reverts to punch mode because the AutoTurnaround 
feature was activated or because the CE test SMS cards were installed as described 
in step 1. 



Format 


is as 


foUows 




Col 


Punches 


Character 


1 

2 


12- 


-1-9 
4-8 


SOH 

% 


3 
4 






1 

3 


5 
6 






Y 
Y 


7 










8 


12- 


-2-9 


STX 



Identifies this card as an RFT (request for test 
message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 






The 2780 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message Card. No errors should 
occur. 

ABCDEFGHIJKLMIMOPQRSTUVWXYZ0123456789 

Note: Each punched output data card will be followed by a blank card. This is a 
normal indication caused by the way the 2780 reverts to AutoTurnaround 
mode. 
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2770 ONLINE TESTS CONTENTION - PRINT 

Before operating these tests be sure that the customer's program has the onHne test 
features option in. Do not try to run these tests if onUne test in the customer's 
program is not available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console, 

4. Press START at the card reader. 

5. Press the ON Line Test button at the 2772 console. 

SOH %01 PRINT TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU then 
transmits the data back to the 2770 that was contained in cc 8—80 of the test 
message card. The CPU sends this message to the 2770 as many times as indicated 
by the punch in cc 5 and 6 of the test message card. 



Format 


is as follows 




Co/ 


Punches 


Character 


1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 








4 


1 


1 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


0-7-9 


ESC 


10 


0-1 




11 






80 


12-3-9 


ETX 



Indicates this card is a RFT (request for 
test message) card. 

Indicates the type of test requested. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Columns 11— 79 can contain any 
non-control characters. The ETX is shown in 
column 80, but it may be placed anywhere in 
the RFT card to denote the end of the message. 

This test should run to the 2770 without error indications. The data contained 
in cc 1 1—79 should print with single spacing the number of times indicated by 
cc 5 and 6. 
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SOH % 12 PRINT TESTS 

The purpose of this test is to request that a stored message from the CPU be sent 
to the 2770 terminal. The 12 designation indicates which transmission code the 
2770 terminal has that is requesting the test (EBCDIC). 



Format 


is as follows 




Col 


Punches 


Character 


1 
2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 

2 


5 
6 




Y 
Y 


7 








8 
9 


12-2-9 
12-3-9 


STX 
ETX 



Identifies this card as an RFT (request for 
test message) card. 

These columns designate a request for a stored 
message. 

Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU program.. 



The following message will print in the 2770 without any errors. The message will 
be single-spaced and print the number of times indicated by cc 5 and 6 of the test 
message card. Each print line should look like this: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



v.,...v 
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2770 ONLINE TESTS CONTENTION - TRANSMIT ONLINE TERMINAL 

TEST FOR THE 
Before operating these tests, be sure that the customer's program has the online ' BIVJ 2780/2770 

tests option in. Do not try to run these tests if ED 60 or Online feature is not 
available. 2770 setup: 

1. Turn the "Transparency" switch on the 2772 console off. 

2. Place the RFT (request for test message) card into the hopper. 

3. Press Check Reset and Term Reset at the 2772 console. 

4. Press START at the card reader. 

5. Press the On Line Test button at the 2772 console. 

SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2770 to transmit a deck of test cards to the 
CPU. The CPU responds with a DLE sequence if no error occurred during trans- 
mission; the CPU responds with a NAK if a CRC or VRC error occurred. There is 
no response for any other type of error. 



Format 


is as follows 




Co/ 


Punches 


Character 


1 
2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 










5 
6 



1 




1 


7 








8 


12-2-9 


STX 



Indicates that this is an RFT (request 
for test message) card. 

Indicates the type of test required. 

For this test, 1 is the only allowable 
number of messages to be sent (see note). 

Denotes the contention terminal. 

Data to be sent as a test. Columns 9—79 can 
contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must be 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9- 79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not held 
depressed, only one card will be sent by the 2770. 

The test messages should be transmitted to the CPU and accepted by it without any 
errors. The audible alarm will sound for a short period after each card and will 
remain on at the end of this test. 
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SOH %15 0R 16 WEAK DIBIT TEST 






The purpose of this test is to request a stored message from the CPU. A stored 
message transmits the worst-case conditions for the data set and communication 
lines. When the RFT (request for test message) card has been transmitter and the 
audible alarm sounds, the 2780 mode switch should be turned to the print or 
punch position and either unit made ready. The output message (weak dibit) will 
then be printed or punched depending upon the position of Mode switch. 



Note: The user has 6 seconds to ready the output unit after the Mode switch is 
turned to the print or punch position. 



Format 


is as follows 




Col 


Punches 


Character 


1 


12-1-9 


SOH 


2 


0-4-8 


% 


3 




X 


4 




X 


5 




Y 


6 




Y 


7 








8 


12-2-9 


STX 


9 


12-3-9 


ETX 



Identifies this as an RFT (request for test message) 
card. 

Identifies the type of stored message we are 
requesting (see note). 

Indicates the number of times we are 
requesting the test (01-99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



Note: Columns 3 and 4 should be punched according to the transmission code and 
line facilities of the terminal involved. 



vy 



Transmission Code 


Column 3 


Column 4 


EBCDIC switched or IBM clock 


1 


5 


EBCDIC leased line 


1 


6 



The 2780 should print or punch the weak dibit message as many times as indicated 
by cc 5 and 6 on a test message card. No errors should occur during the test. If line 
errors occur during this test but not during any of the other online tests, the data 
set or communications line may be failing. The dibit characters may not print or may 
print as something else. Operating with no line check is the basic goal of this test. 
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2770 ONLINE TESTS CONTENTION - PUNCH 

Before running these tests be sure that the customer's program has online test 
option in. Do not try to run these tests if online test feature is not available. 
2770 setup: 

1 . Be sure POWER is on for the 545 card punch and that it is initiaUzed. 

2. Turn the "Transparency" switch on the 2772 console off. 

3. Place the RFT (request for test message) card into the hopper. 

4. Press Check Reset and Term Reset as the 2772 console. 

5. Press START at the card reader. 

6. Press the On Line Test button at the 2772 console. 



SOH %01 PUNCH TEST 

The purpose of this test is to transmit a test message card to the CPU. The CPU 
then transmits data to the 2770 that was contained in cc 8—80 of the test message 
card. The CPU will send this message as many times as indicated by the punching 
in cc 5 and 6 of the test message card. The 2770 automatically reverts to punch 
mode. 



Format 


is as follows 




Col 


Punches 


Character 


1 
2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 



1 



1 


5 
6 




Y 
Y 


7 








8 

9 

10 

11 

80 


12-2-9 
0-7-9 

4 


STX 

ESC 

4 



Identifies this card as an RFT (request for test 
message) card. 

Indicates the type of test requested. 



Indicates the number of times the test is 
requested (01-99). 

Denotes a contention terminal. 

This is the message the CPU will send back 
to the 2770. Any non-control characters can 
be punched in cc 1 1—80. 



This test should operate to the 2770 with no error indications. The 2780 should 
punch the data contained in cc 1 1—80 of the RFT card in cc 1—69 of the punched 
output card. 

Note: Each punched output data card will be followed by a blank card. 
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Appendix N 

ONLINE TERMINAL 
TEST FOR THE 
IBM 2780/2770 



SOU % 13 PUNCH TEST 

The purpose of this test to request that a stored message from the CPU be sent to 
the 2770 terminal. The 13 designation indicates which transmission code is to be 
used. The 2770 automatically reverts to punch mode. 

Format is as follows: 



Col 



Punches Character 



Identifies this card as an RFT (request for 
test message) card. 

These columns indicate a request for a 
stored message. 

Indicates the number of times that a test 
is requested (01—99). 

Denotes a contention terminal. 

Ending sequence required by the CPU. 



The 2770 should punch the following data into cc 1—36 of the output cards as 
many times as indicated by cc 5 and 6 of the test message card. No errors should 
occur. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 



1 

2 


12-1-9 
0-4-8 


SOH 

% 


3 
4 




1 
3 


5 
6 




Y 
Y 


7 








8 


12-2-9 


STX 
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2780 ONLINE TESTS CONTENTION - TRANSMIT AND WEAK DIBIT 

Before operating these tests, be sure that the customer's program has the online 
tests option in Do not try to run these tests if ED 60 or Online feature is not 
available. 2780 setup: 

1. Place the Operate/Test switch on the data set cable and on the 2780 CE panel 
to the operate position. 

2. Turn the Mode switch on the 2780 console to the transmit position. 

3. Flip the Online Test switch located on the CE panel into the ON position. 

4. Place the RFT (request for test message) card or cards into the hopper. 

5. Depress the Serial Reader Punch Start key to begin the test. 

The following online test procedures may be used for switched and leased-line 
IBM 2770s. 



SOH % 00 TRANSMIT TEST 

The purpose of this test is to allow the 2780 to transmit a deck of test cards to 
the CPU. The CPU responds with a DLE sequence if no error occurred during 
transmission; the CPU responds with a NAK if a CRC or VRC error occurred. 
There is no response for any other type of error. 

Format is as follows: 

Col Punches Character 

1 12-1-9 SOH Indicated that this is an RFT (request 

2 0—4—8 % for test message) card. 

3 Indicates the type of test required. 

4 

5 For this test, 01 is the only allowable 

6 1 1 number of messages to be sent (see note). 

7 Denotes a contention terminal. 

8 12—2—9 STX Data to be sent as a test. Columns 9— 79 can 

contain any non-control characters. 

80 12-3-9 ETX Last card only. 

Note: Columns 5 and 6 of the transmit test must be 01. In order to transmit more 
than one card, a deck of cards must be punched with the same control 
characters in cc 1-8 and cc 80 of the test message card. Any non-control 
characters can be punched in cc 9-79. Place this deck into the hopper and 
hold the start key depressed until a buffer is read. If the start key is not 
held depressed, only one card will be sent by the 2780. 

The test messages should be transmitted to the CPU and accepted by it without 
any errors. The audible alarm will sound for a short period after each card and 
will remain on at the end of this test. 



Appendix N 

ONLINETERMINAL 

TEST FOR THE 

IBM 2780/2770 
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Appendix O 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example, Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics/The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3: Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,PRINT,SUM,SUMTAPE,VOL 

/* 

A work tape is required because the VOL option is specified-The work tape will 
contain a sequential list of all volume serial numbers along with a 5-byte disk 
address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
respond END. If the operator chooses not to mount a work tape, he should respond 
CANCEL END. This causes the SUM and PRINT TES options to be canceled. Any 
other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 
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Example 4: Update the TES history tape on SYS007. Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
// EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 
/* 

First the TES history tape is updated: the message 

3E09 A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 



Appendix O 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 




An example of the EREP TES print formats. 
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Appendix P 

EXAMPLES OF THE 
SUM OPTION OF EREP 



Note: This option of 
EREP is only applic- 
able to the Model 145 



Example 1 : The job control statements required ibr a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

//EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 271 5 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 1 5 

/* 

The 2715 groups is summarized first 



Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009,X'283' 

// TLBL EREPNEW 

// LBLTYP TAPE 

// EXEC EREP 

OPTION SELECT ,TAPE 

DEVICE=2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 



\.J 
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DOS/VS Serviceability Aids and Debugging Procedures 

GLOSSARY 






This glossary contains technical terms associated with the subject of this publication. A more general range of terms 
is contained in IBM Date Processing Glossary, GC20-1699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for information Processing (copyright © 1970 by American National Standards 
Institute, Incorporated) which was prepared by subcommittee X3K5 on Terminology and Glossary of American 
National Standards Committee X3. These definitions are indicated by an asterisk. 



A 



B 



address translation. The process of changing the 
address of an item of data or an instruction from its 
virtual address to its real storage address. See also 
dynamic address translation. 

asynchronous, without regular time relationship. 

auxiliary storage. Data storage other than real 
storage; for example, storage on magnetic tape or 
disk. Synonymous with external storage, secondary 
storage. 



basic control mode. When PSW bit 12 is 0, PSW 

format and system operation are compatible with 
standard System/360 operation. This is the basic 
control mode in which control registers 0, 8, and 
14 are available to the system. Abbreviated to BC 
mode. See also "Extended Control Mode." 

BTAM (basic telecommunications access method). 
A basic access method that permits a READ/WRITE 
communication with remote devices. 

buffer. (1) A storage device in which data is 
assembled temporarily during data transfer. (2) During 
I/O operations, a portion of real storage from which 
data is read or into which data is written. 



channel program. One or more Channel Command 
Words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the specific 
sequence is initiated by a single start I/O instruction. 

channel program translation. In a channel program, 
replacement, by software, of virtual addresses with 
real addresses. 

command control block (CCB). A 16-byte field 
required for each channel program executed by 
physical IOCS. This field is used for communication 
between physical IOCS and the problem program. 

communication region. An area of the supervisor 
set aside for interprogram and intraprogram communi- 
cation. It contains information useful to both the 
supervisor and the problem program. Abbreviated 
comreg, (Not to be confused with the COM RG macro 
instruction). 



control program. A program that is designed to 
schedule and supervise the performance of data 
processing work by a computing system. 

control registers. A set of registers used for operating 
system control of relocation, priority interruption, 
program event recording, error recovery, and masking 
operations. 

core-wrap mode. The method of operation that 
records the events of a trace in the PD area or an 
alternate area (used by PDAIDS). It is the default 
process when no output device for a PDAID trace 
has been specified. 



DTF (define the file) macro instruction. A macro 
instruction that describes the characteristics of a 
logical input/ output file, indicates the type of 
processing for the file, and specifies the I/O areas 
and routines to process the file. 

default value. The choice among exclusive alternatives 
made by the system when no explicit choice is 
specified by the user. A default value is indicated by 
underlining in tables listing parameters. 

diskette. A flexible magnetic oxide coated disk, 
permanently enclosed in a semi-rigid protective 
plastic jacket approx, 8 inches square. During data 
processing operations the disk turns freely within 
the jacket. It is capable of storing 1898 128 character 
data records. 

dump. (1) To print out the contents of all or part 
of virtual storage or of auxiliary storage (2) The 
data resulting from the process as in (1). 

dynamic address translation (DAT). (1) The change 
of a virtual storage address to an address in real 
storage during execution of an instruction. (2) A 
hardware feature that performs the translation. 



emulator (1) * A device or computer program that 
emulates. (2) The combination of programming 
techniques and special machine features that permits 
a given computing system to execute programs 
written for another system. 
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environmental recording, editing, and printing 

(EREP). A program that processes the data 
contained on the system recorder file. 
error recovery procedures. Procedures designed to 
help isolate, and, when possible, to recover from 
hardware errors in equipment. The procedures are 
often used in conjunction with programs that record 
the statistics of machine malfunctions. 

error volume analysis (EVA). With this option, the 
system issues a message to the operator when a 
number of temporary read or write errors (specified 
by the user at system generation time) has been 
exceeded on a currently accessed tape file. 

event. An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/output. 

extent. The physical locations on Input/Output 
devices occupied by or reserved for a particular 
volume. 

extended control mode. When PSW bit 1 2 is set to 1 , 
the PSW format is changed from that used for 
standard System/360 operation: the channel mask 
bits, instruction length code, and interruption code 
are removed, and additional mode and mask bits are 
included. This is the extended control mode, in 
which all control registers are available to the system 
for control of facilities that are particular to System/ 370. 
Abbreviated to EC mode. See also "Basic Control Mode." 



fetch. (1) To bring a program phase into real storage 
from a core image library or from the page data set 
for immediate execution. (2) The routine that 
retrieves requested phases and loads them. (3) The 
name of a macro instruction (FETCH) used to 
transfer control to the system loader. (4) To transfer 
control to the system loader. 

* file. A collection of related records treated as a unit. 
For example, one Une of an invoice may form an item, 
a complete invoice may form a record, the complete 
set of such records may form a file, the collection of 
inventory control files may form a library, and the 
libraries used by an organization are known as its 
data bank. 



H 



&ced page. 

paged out. 



A page in real storage that is not to be 



F/L Trace (Fetch/Load Trace). A program that 
records information about phases and transients as 
they are called from a core image library. 

GSVC Trace (Generalized Supervisor Calls Trace). 

A program that records SVC interrupts as they occur. 
All or a selected group of SVCs can be traced. 



hard copy. A printed copy of machine output in a 
visually readable form, for example, a printed 
recording of the messages displayed on the System/370 
Model 125 video display unit. 

hard stop. A condition, usually caused by an error, 
in which the CPU is stopped and is not executing the 
microprogram. 

* hardware. Physical equipment, as opposed to the 
computer program or method of use, for example, 
mechanical, magnetic, electrical, or electronic devices. 
Contrast with software. 



Input Job Stream, A sequence of job control state- 
ments entering the system, which may also include 
input data. 

interface. A shared boundary. An interface might 
be a hardware component to link two devices or it 
might be a portion of storage or registers accessed by 
two or more computer programs. 

interrupt. A break in the normal sequence of 
instruction execution. It causes an automatic transfer 
to a preset storage location where appropriate 
action is taken. 

invalid page. A page that cannot be directly addressed 
by the dynamic address translation feature of the 
central processing unit. 

I/O area. An area (portion) of real storage into which 
data is read or from which data is written, the term 
buffer is often used in place of I/O area. 

I/O Trace (Input/Output Trace). A program that 
records I/O device activity for all or a selected group 
of I/O devices. 

IOCS (input/output control system). A group of 
macro instruction routines provided by IBM for 
handling the transfer of data between main storage 
and external storage devices, 

irrecoverable error. A hardware error which cannot 
be recovered from by the normal hardware and retry 
procedures. 

job. (1) * A specified group of tasks prescribed as a 
unit of work for a computer. By extension, a job 
usually includes all necessary computer programs, 
linkages, files, and instructions to the operating 
system. (2) A collection of related problem programs, 
identified in the input stream by a JOB statement 
followed by one or more EXEC statements. 
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linkage editor. A processing program that prepares 
the output of language translators for execution. It 
combines separately produced object or load modules; 
resolves symboHc cross references among them, and 
generates overlay structures on request; and produces 
executable code (a load module) that is ready to be 
fetched into virtual storage. 

load. In programming, to enter instructions or data 
into storage or working registers. In DOS/VS, to bring 
a program phase from a core image library into virtual 
storage for execution. 

logic module. The logical IOCS routine that provides 
an interface betv^een a processing program and 
physical IOCS. 

* loop. A sequence of instructions that is executed 
repeatedly until a terminal condition prevails. 

LSERV (label cylinder display). A program that 
formats a Hsting of the label cylinder located on 
SYSRES. 



M 



machine check analysis and recovery. A feature that 
checks the severity of a CPU hardware failure and 
attempts to recover from the interrupt. Abbreviated 
MCAR. 

machine check interrupt. The interrupt that occurs 
if the CPU fails to operate. 

main page pool. The set of all page frames in real 
storage not assigned to the supervisor or one of the 
real partitions. 

main storage. (1) The real address area of virtual 
storage. Contrast with auxiUary storage. (2) All 
program addressable storage from which instructions 
may be executed and from which data can be 
loaded directly into registers. 

microprogram. A set of basic or elementary machine 
instructions that is loaded into control storage to 
control CPU operations. 



transferring records over the multiplexer channel, 
time sharing it on a byte basis. 

multiplexer mode. A means of transferring records 
to or from low-speed I/O devices on the multiplexer 
channel, by interleaving bytes of data. The multi- 
plexer channel sustains simultaneous I/O operations 
on several subchannels. Bytes of data are interleaved 
and then routed to or from the selected I/O devices 
or to and from the desired locations in main storage. 
Multiplex mode is sometimes referred to as byte mode. 

multiprogramming system. A system that controls 
more than one program simultaneously by interleaving 
their execution. 

multitasking. The concurrent execution of one main 
task and one or more subtasks in the same partition. 



offline. (1) * Pertaining to equipment or devices 
not under control of the central processing unit. 
(2) Pertaining to program error diagnosis without 
using the computer system (offline program 
debugging). 

* online. (1) Pertaining to equipment or devices under 
control of the central processing unit. (2) Pertaining 
to a user's abiUty to interact with a computer. 

online test executive program (OLTEP). The control 
program of the online test system. OLTEP is the 
interface between the online test and the operating 
system. 

operand. (1) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (2) Information entered with a command 
name to define the data on which the command 
processor operates and to control the execution of 
the command processor. 

* overflow. (1) That portion of the result of an 
operation that exceeds the capacity of the intended 
unit of storage. (2) Pertaining to the generation of 
overflow as in (1). 



module. A program unit that is discrete and 
identifiable with respect to compiHng, combining 
with other units, and loading, for example, the input 
to, or output from, an assembler, compiler, linkage 
editor, or executive routine. 

multiplexer channel. A channel designed to operate 
with a number of I/O devices simultaneously on a 
byte basis. That is, several I/O devices can be 



page. (1) A fixed-length block of instructions, data, 
or both, that can be transferred between real storage 
and external page storage. (2) To transfer instructions, 
data, or both between real storage and external page 
storage. 

page data set. An extent in auxiliary storage, in 
which pages are stored. 
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page fault. A program interruption that occurs when 
a page that is marked "not in real storage" is referred 
to by an active page. Synonymous with page translation 
exception. 

page frame. A 2K block of real storage that can 
contain a page. 

page frame table. In DOS/VS, a table that contains 
an entry for each frame. Each frame table entry 
describes how the frame is being used. 

processor. (1) * In hardware, a data processor. (2) * In 
software, a computer program that includes the com- 
piling, assembling, translating, and related functions 
for a specific programming language. RPG II processor, 
FORTRAN processor. (3) Same as processing program. 

Private Second Level Directory (PSLD). The Private 
Second Level Directory is a table, located in the 
Supervisor and containing the highest phasenames 
found on the corresponding directory tracks of the 
Private Core Image Library. 

page pool. The set of all page frames that may 
contain pages of programs in virtual mode. 

page table (PGT). A table that indicates whether a 
page is in real storage and correlates virtual addresses 
with real storage addresses. 

page translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invaUd bit in the page 
table entry for that address is set. See also segment 
translation exception, translation specification 
exception. 

paging. The process of transferring pages between 
real storage and the page data set. 

parameter. A variable that is given a constant value 
for a specific purpose or process. 

physical IOCS. Macro instructions and supervisor 
routines (Channel Scheduler) that schedule and 
supervise the execution of channel programs. 
Physical IOCS controls the actual transfer of records 
between the external storage medium and real 
storage. 

problem determination aids (PDAID). Programs that 
trace a specified event when it occurs during the 
operation of a program. The traces provided are: 
QTAM Trace, I/O Trace, F/L Trace, and GSVC 
Trace. 

problem program. (1) The user's object program. It 
can be produced by any of the language translators. 
It consists of instructions and data necessary to solve 



the user's problem. (2) A general term for any 
routine that is executed in the data processing 
system's problem state; that is, any routine that 
does not contain privileged operations. (Contrasted 
with Supervisor.) 

processing program. (1) A general term for any 
program that is not a control program. (2) Synonymous 
with problem program. 

program event recording. A System/370 feature that 
enables a program to be alerted to specific events. 
Abbreviated PER. 



Q 



QTAM Trace. A program that records certain 
supervisor and I/O activities on tape or in core-wrap 
mode. 

queue. (1) A waiting line or Hst formed by items in 
a system waiting for service; for example, tasks to 
be performed or messages to be transmitted in 
message switching system. (2) To arrange in, or 
from, a queue. 



R 



real address. 

storage. 



The address of a location in real 



real address area. In DOS/VS, the area of virtual 
storage where virtual addresses are equal to real 
addresses. 

real mode. In DOS/VS, the mode of a program that 
may not be paged. 

real storage. The storage of a System/370 computing 
system from which the central processing unit can 
directly obtain instructions and data, and to which it 
can directly return results. Synonymous with processor 
storage. 

real partition. In DOS/VS, a division of the real 
address area of virtual storage that may be allocated 
for programs that are not to be paged, or programs 
that contain pages that are to be fixed. 

recovery management support. The facilities that 
gather information about hardware reliability and 
allow retry of operations that fail because of CPU, 
I/O device, or channel errors. Abbreviated to RMS. 

reenterable. The attribute of a set of code that 
allows the same copy of the set of code to be used 
concurrently by two or more tasks. 

reliability data extractor (RDE). A function that 
provides hardware reliabiUty data that is analyzed by 
IBM. 
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relocatable library. A library of relocatable object 
modules and IOCS modules required by various 
compilers. It allows the user to keep frequently used 
modules available for combination with other 
modules without recompilation. 

resource. Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the 
central processing unit, data files, and control and 
processing programs. 

Rotational Position Sensing. A standard feature of IBM 
3330/3333 and an optional feature of IBM 3340 disk 
storage devices. It permits a device to disconnect from 
a block multiplexer channel (or its equivalent on Model 
31 15/3125 CPUs) during rotational positioning opera 
operations, thereby allowing the channel to service other 
devices on the channel during the positioning delay. 

routine. An ordered set of instructions that may have 
some general or frequent use. 



Second Level Directory (SLD). The table, located 
in the Supervisor and containing the highest phase- 
names found on the corresponding directory tracks 
of the system core image . 

segment. A continuous 64K area of virtual storage, 
which is allocated to a job or system task. 

segment table (SGT). A table used in dynamic 
address translation to control user access to virtual 
storage segments. Each entry indicates the length, 
location, and availability of a corresponding page 
table. 

segment translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invaUd bit in the segment 
table entry for that address is set. See also page 
translation exception, translation specification 
exception. 

self-relocating. A programmed routine that is loaded 
at any doubleword boundary and can adjust its 
address values so as to be executed at that location. 

self-relocating program. A program that is able to 
run in any area of storage by having an initiahzation 
routine to modify all address constants at object time. 

selector channel. A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at 
a time, 

SEREP. A stand-alone environment recording, 
editing, and printing program that makes the data 
contained in an error logout area of real storage 
available for further analysis. 
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Shared Virtual Area (SVA): The last part of the 
virtual system address space that contains phases 
which are reenterable and relocatable and which can 
be shared between partitions. 

soft stop. A condition in which the CPU has stopped 
processing but continues to handle any requested 
interruptions. 

stand-alone dump. A program that displays the 
contents of the registers and all of real storage and that 
runs independently and is not controlled by DOS/VS. 

subtask. A task in which control is initiated by a 
main task by means of a macro instruction that 
attaches it. 

' storage protection. An arrangement for preventing 
access to storage for either reading, or writing, or 
both. 

system generation. The process of tailoring the IBM 
supplied operating system to user requirements. 

system debugging aids. A set of routines provided 
to trace specific program events by using the program 
event recording facilities. Abbreviated SDAIDS. 

System Directory list (SDL). A list of highly used 
phases (either only in the system CIL or also in the 
SVA). This list is placed in the SVA. 

system recorder file. The data file that is used to 
record hardware reliability data. 

task. A unit of work for the central processing unit 
from the standpoint of the control program. 

task selection. The supervisor mechanism for 
determining which program should gain control of 
CPU processing. 

teleprocessing. The processing of data that is received 
from or sent to remote locations by way of telecom- 
munication lines. 

terminal. (1) * A point in a system or communication 
network at which data can either enter or leave. (2) Any 
device capable of sending and receiving information 
over a communication channel. 

Terminating partition. This is a partition owning a 
program which is in the process of being terminated 
either because of a program cancel condition or 
because of EOJ. 

trace. (1) To record a series of events as they occur. 
(2) The record of a series of events. 

■ tracing routine. A routine that provides a historical 
record of specified events in the execution of a program. 
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track hold. A function for protecting DASD tracks 
that are currently being processed. When track hold is 
specified in the DTF, a track that is being modified by 
a task in one partition cannot be concurrently accessed 
by a task or subtask in another partition. 

transient area. An area in the supervisor used for 
temporary storage of transient routines, such as non- 
resident supervisor call or error-handUng routines. 

transient routines. These self-relocating routines are 
permanently stored on the system residence device 
and loaded (by the supervisor) into the transient area 
when needed for execution. 

translation specification exception. A program inter- 
ruption that occurs when a page table entry, segment 
table entry, or the control register pointing to the 
segment table contains information in an invalid 
format. See also page translation exception, segment 
translation exception. 



U 



user program, see problem program. 

unrecoverable error, see irrecoverable error. 

utility program. A program designed to perform a 
routine task, such as transcribing data from one 
storage device to another. 



V 



virtual address. An address that refers to virtual 
storage and must, therefore, be translated into a real 
storage address when it is used. 



virtual address area. In DOS/VS, the area of virtual 
storage whose addresses are greater than the highest 
address of the real address area. 

virtual mode. In DOS/VS, the mode of a program 
which may be paged. 

virtual storage. Addressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addressing scheme of 
the computing system and by the amount of auxiliary 
storage available, rather than by the actual number 
of real storage locations. 

virtual storage access method (VSAM). VSAM is an 
access method for direct or sequential processing of 
fixed and variable length records on direct access 
devices. The records in a VSAM file can be organized 
either in logical sequence by a key field (key sequence) 
or in the physical sequence in which they are written 
on the file (entry-sequence). A key sequenced file has 
an index, an entry-sequenced file does not. 

volume. (1) That portion of a single unit of storage 
media which is accessible to a single read/write mechanism, 
for example, a drum, a disk pack, or part of a disk 
storage module. (2) A recording medium that is 
mounted and dismounted as a unit, for example, a reel 
of magnetic tape, a disk pack, a data cell. 

VSAM access method services. A multifunction utility 
program that defines VSAM files and allocates space 
for them, converts indexed sequential files to key- 
sequenced files with indexes, faciKtates data portabihty 
between operating systems, creates backup copies of 
files and indexes, helps make inaccessible files accessible, 
and lists file and catalog entries. 
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AB option table 4.102 

ABSAVEarea 4.108 

ACB, contents of 4.76 

ACB macro 4.76 

Address trap, see stop on address 

see also data compare trap 
Address translation, see channel program translation 

see also converting address 
ALTER command 2.6 
example of output 2.6 
format of 2.6 
restrictions of use 2.7 
when to use 2.7 
ALTER/DISPLAY console operation all Models 2.1 31 
error indications Models 115/125 2.142, 2.143 
error messages. Models 135/145/155-11 2.132 
examples of display, Model 115/125 2.142, 2.143 
examples of displays. Model 158 2.144 
examples of output. Models 135/145/155-11 2.136 
how to use, operators flowchart 
Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
options 

Models 135/145/155-11 2.134 
Models 115/125 2.140 
when to use 2.132 
Altering SDAID parameters (after SDAID initialization) 2.87 
Altering storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.132 
Altering the contents of 
control registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
general purpose registers 

Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.144 
virtual storage locations 

using the ALTER command 2.6 
using the ALTER/DISPLAY console operation 2.1 32 
Alternate area, for PDAID core-wrap output 2.41 
dumping 2.60 

example of, in a stand-alone dump output A. 16 
locating 2.60 
specifying 2.60 
Analyzing information (general) 1.28 
Analyzing information obtained from 
DSERV program 2.114 
EREP, example of 2.114 
Library display programs 2.115 
Linkage editor diagnostic of input 2.182 

examples of error indications 2.182, 2.183 
Linkage editor map 2.13, 2,166 
LSERV program 2.110 
LVTOC program 2.121, 2.122 
Map command 2.169 
PDAID trace routines 2.39 
SDAID trace routines 2.74 
Stand-alone dump, example of 
System dump, example of 2, 1 3 
SYSVISdump 2,130 

see also flowcharts (for the programmer) 4. 1 
Areas destroyed by the stand-alone dump program, 
example of, (in a stand-alone dump output) A.l 1 
see also non-critical area 
Assembler language macros 
Declarative macros 

forLIOCS 4.65,4.67 
forVSAM 4,72 



Assembler language macros (continued) 
Imperative macros 

forLIOCS 4,65 

forVSAM 4,72,4,73 
Module generation macros 4.68 
Supervisor communication macros 2.32 
VSAM file description macros 4.72 

SHOWCB macro, using 4.73 

TESTCB macro, using 4.73 



B 



Boundary box 4.115 

example of (in a dump output) A. 14, A. 25 
explanation of the contents of 4.1 15 
how to locate 4.115 



Cancel codes and messages 4.94 

causes of code X'2 1 ', 4 .24 

Ustof 4.94,4,95 

use of, and location 4.94 
CanceUing the SDAID non-destroying dump 2. 84 
CANCELV command 2,120 

example of 2.121 
Cathode ray tube. Model 115 and 125, example of 1.25 

see also Model 115 and 125 displays 

see also Model 158 displays 
CCB macro, example of 4,64 
CCW assembler instruction, example of 4,64 
CCW copy block 4,126 

example of, in a dump output A. 15 

format and contents of 4.126 
CCW/Translation control block 4.1 27 
Changing real address to virtual 4.1 18 

using the ALTER command 2.6 

using the ALTER/DISPLAY console operation 2.1 32 
Changing the contents of control registers 

Model 135/145/155-11 2.135 

Model 115/125 2,141 

Model 158 2,144 
Changing the contents of general registers 

Models 135/145/155-11 2.135 

Models 115/125 2,141 

Model 158 2,144 
Changing virtual addresses to real 4,116 
Channel Address Word (CAW) 2,171 

format and contents 2, 1 7 1 

how to locate 2.175 
Chaimel bucket 4.58 

examination of 4.58 

explanation of the contents of 4.59 

how to locate 4.58 
Channel Check Handler (CCH) 2.197 
Channel Cotnmand Word (CCW) 4.83 

format and contents 4.83 

how to locate 4,83 

see also channel program 
Channel control table 4.5 8 

explanation of the contents of 4.59 

how to locate 4,58 
Channel Status Word (CSW) 2, 172 

format and contents 2.172 

how to locate 2.175 
Channel Queue (CHANQ) 4.56 

examination of 4.56 

explanation of the contents of 4.57 

format of 4.57 

how to locate 4.56 
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C (continued) 

Channel program 4.82 

how to locate 4.83 
Channel program translation 4.120-4.128 
Clear, option of EREP 2.210 
Clear real storage, console operation 2.163 
Codes, list of, table of 

Cancel codes 4.94, 4.95 

causes of message 0S04I, list of 4.24 

control statements for DUMPGEN 

for DTP types 4.67 

for I/O device types 4.50-4.52 

for IPL reason information 2.204 

operands for the DUMP command 2.10 

options for ALTER/DISPLAY console operation 
Models 135/145/155-11 2.134 
Models 115/125 2.140 
Model 158 2.144 

options for DUMPGEN 2.16 

options for EREP 2.209 

options for LISTIO command/statement 2.168 

parameters for initializing PDAID 2.62 

parameters for the MODE command 2.205, 2.206 

parameters for initializing SDAID 2.88 

parameters for the SELECT option of EREP 2.212 

parameters for initializing the transient dump 2.28 

program check interrupt codes, hst of 4.109 

SDAID output classes, table of 2.79, 2.280 

type of debugging aids, reference hst 2.3 

wait state message codes 2.176, 3.3, 3.4, 4.6 
Combined recording 2.201,2.215 
Commands 

ALTER 2.6 

CANCELV 2.120,2.121 

DSPLY 2.8 

DSPLYV 2.120,2.122 

DUMP 2.10 

LISTIO 2.166,2.167,2.168 

LOG 2.168 

MAP 2.169 

MODE 2.205 

NOLOG 2.168 

ROD 2.203 
Computer output, see examples 
Command Control Block (CCB) 4.71-4.81 

examination of 4.77 

example of in a dump output 4.78, A.15 

format and contents 4.79-4.81 

how to locate 4.77 
Communication regions 4.34-4.43 

example of, in a dump output A. 13 

for each partition 4.34 

locating, example of 4.34 
COMRG macro 4.34 
Console dump operation (Model 1 15/125) 2.134 

operators flowchart 2.135 
Contents of, see explanation of the contents of 
Control of input and output, see IOCS 
Control registers 

allocation A.6 

altering the contents of and displaying 
Models 135/145/155-11 2.135 
Models 115/125 2.141 
Model 158 2.145 

dumping, see dumps 
Conventional dump, (Translating dump), example of A.l 1-A.30 
Converting Addresses 

real to virtual 4.118 

virtual to real 4.116 
Copying the Page Set (PDS) 2.126 
Core-wrap output, for PDAID 2.41 
CPU ID 

example of, in SDAID output 2.95 

example of, in stand-alone dump A. 12 



NDEX 



Current PSW 

dumping, displaying 

Models 135/145/155-11 2.135 
Models 115/125 2.140,2.141 
Model 158 2.145 

format and contents 2.173 



D 



Data compare trap 

Model 145 2.155 

Model 158 2.158 
Debuggers flowcharts, see flowcharts 
Debugging 1.4 

aids for, reference list of 2.3 

definition 1.4 

pictorial representation of 1.2, 1.5 
Debugging aid output, see examples 
Debugging hints 

for initializing SDAID 2.87 

forVSAM 4.72,4.73 

to analyze the stand-alone dump output 2.22, A11-A30 

to locate the CCB 4.78 
Declarative macro 4.65 
De-editing service program (ESERV) 2.116 
Define the file (DTP) macro 4.65 

contents of a DTFMT 4.66 

example of a DTPMT 4.70 
Description of 

Cancel codes 4.94 

Channel program 4.82 

Channel program translation 4.120 

Command Control Block (CCB) 4.76 

Control registers A.6 

Debugging 1.4 

DUMPGEN program 2.15 

EREP 1.23, 2.207 

ESTVUT 2.219 

EVA 2.202 

General registers, uses of 4.96 

Hard wait 1.10 

Indicators, for wait/loop 1.12 

Incorrect output 1.13 

I/O device malfunctions 1.16 

Input/output control system 4.62 

Intermittent errors 1.14 

Job accounting interface A.31-A.34 

Label information cylinder display program ( LSER V) 2.102 

Logical IOCS 4.62 

Loop tracing 1.20 

Low address storage 1.18, 2.171 

Machine Check Interrupt (MCI) 2.196 
illustration of 2.191 
Soft MCI 2.192 
Hard MCI 2.192 

MAP command 2.169 

Models 115/125 maintenance log analysis 1.25, 2.230 

Model 158 display frames 1.26,2.2 

OLTEP 2.234 

Page management 4.112 

PDAID trace routines 2.39 

Physical IOCS 4.62 

Program check interrupt (PGMCHK) 1.15 

Program Interrupt Key (PIK) A.3 

Recovery Management Support (RMS) 1.21, 2.188 
iUustration of 1.22,2.189 

Save areas 4.106 

SDAID dump facilities 2.75 

SDAID trace routines 2.74 

SEREP 1.24,2.226 

Soft wait 1.10 

Standalone dump program 2.18 
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INDEX D (continued) 

Description of (continued) 

Storage dumps 1.19,2.5-2.35 
Supervisor calls (SVCs) 4.84 
Supervisor I/O tables and information blocks 4.44 
SYSLOGID A.3 
System Dump 2.12 
System malfunctions 1.6 
SYSVIS dump program 2.15 
Tables used by the page manager 4.112 
Transient dump program 2.25 
Unintended program loop 1 .8 

Volume table of contents display program (LVTOC) 2.1 IJ 
Wait state 1.10 
Wait state messages 2.176 
Details of contents for 

Partition communication regions 4.35-4.41 
System communication region 4.42, 4.43 
Device type codes 4.50-4.52 

Discontinuing the SDAID non-destroying dump 2.84 
Display command, see DSPLY command 
Display frame (Model 158) 
Display operators Console (DOC) 1.25 

see also Models 115/125 display, examples of 
see also Model 158 frames, examples of 
Displaying libraries, SSERV, RSERV, CSERV, PSERV 2.1 11 
Displaying library directories, DSERV 2.1 1 1 
Displaying the contents of 

any partition, see DUMP command 
control registers 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Label information cylinder, see LSERV 
Libraries 2.111 
Logout areas, see SEREP 

see also maintenance program selection and log analysis 
Low address storage, see SDAID output classes (LOCORE) 

see also dumps 
Page management tables 

see SDAID output (PAGET AB) 2.79 
Partition 

see DUMP command 

see also DUMP and JUMP macro 

see also system dump or // OPTION DUMP 
Real storage, see ALTER/DISPLAY console operation 

see also SDAID output (DUMPREAL) 

see also stand-alone dump 
Small areas of real and virtual storage 

see DSPLY command 

see also Snap Shot dump 
Supervisor, see SDAID output (SUPVISOR) 

see also DUMP command 
SYSREC, see EREP 

SYSVIS (Page Data Set), see SYSVIS dump 
Virtual storage, see ALTER /DISPLAY console operation 

see also dumps 
Virtual storage locations 

see ALTER/DISPLAY console operation 

see also dumps 
Volume table of contents, see LVTOC 

see also CANCELV command 

see also DSPLYV command 
VSAM control blocks 4.74 
DSPLY command 2.8 
example of output 2.8 
format of 2.8 
restrictions of use 2.9 
when to use 2.9 
DSPLYV command 2.120 

examples of output 2. 1 21 
DTP type codes, list of 4.67 
DTFMT 

contents of 4.66 



DTFMT (continued) 

example of in a dump output 4.70 
in an assembly listing 4.70 
Dump Analysis 

Stand-alone dump output A.11-A.30 
System dump output 2.13, 2.14 
Transient dump output 2.31 
DUMP command 2.10 

examples of output 2.1 1 
format of 2.10 
operands 2.10 
when to use 2.11 
DUMP macro 2.34 

consideration of use 2.35 
format of 2.34 
information dumped 2.34 
when to use 2.35 
DUMPGEN 2.15 

control statement 2.17 
executing 2.15 
job stream example 2.17 
messages 2.17 
operands 2.16 
DUMPGEN and stand-alone dump 2.15 
DUMPS 

DSPLY command 2.8 

DUMP command 2.10 

DUMP macro 2.34 

Dumping the copy of SYSVIS to SYSLST 2. 1 27 

Dumping a partition 

using the DUMP command 2.10 

using the DUMP macro 2.34 

using the JDUMP macro 2.34 
Dumping communication regions 

SDAID output class 4 (COMREG) 2.79, 2.98 
Dumping low address storage 

SDAID output class 3 (LOCORE) 2.79, 2.97 
Dumping page management tables 

SDAID output class 5 (PAGETAB) 2.79, 2.97 
Dumping real storage 

SDAID output class 7 (DUMPREAL) 2.79 
Dumping SYSREC, see EREP 
Dumping SYSVIS (PDS) to tape or disk 2.126 
Dumping the alternate area 2.53, 2.60 
Dumping the logout areas, see SEREP 
Dumping the PD area 2.44, 2.56 
Dumping the supervisor 

SDAID output class 6 (SUPVISOR) 2.79 

see also DUMP command 
Dumping the SVA, see system dump 
Formatting dump 2.19 

example of A. 18- A. 30 
JDUMP macro 2.34 
Printing the contents of SYSVIS 2.128 
Printing the system recorder file, see EREP 
Printing the tape used for PDAID output (PDLIST) 2.41 
SDAID dump routines 2.75 

Dump on program check 2.85 

Non-destroying dump 2.84 

Stop and dump routines 2.83 
Snap shot dump 

PDUMP macro 2.32 

SDAID PDUMP, SDAID output class 8 (PDUMP) 2.83 
Stand-alone dump 2.18 

example of A.11-A.30 

pictorial representation of 1.19 
Stop on event and dump selected SDAID output 2.83 
System dump 2.12 
SYSVIS dump 2.125 
Translating dump, example of 2. 1 3 , 2. 1 4 
Transient dump 2.25 
Dumps controlled by JCS 2.12 
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D (continued) 

Dumps controlled by JCS (continued) 

// OPTION DUMP (system dump) 2.12 
Dumps invoked by operator command 2.6 

DSPLY (display) command 2.8 

DUMP command 2.10 
Dump on program check (SDAID) 2.85 

when to use 2.85 

see also // OPTION DUMP (system dump) 
Dynamic dump 

PDUMP macro 2.32 

SDAID PDUMP 2.78 
Dynamic reallocation of partition or page pool (DRAP) 2.1 96 



ED IT, option of EREP 2.210 
Editing, the source statement library 

using ESERV 2.116 

using SSERV 2.111 
Editor, linkage 2.181 
Environmental Recording, Editing, and Printing 1.23, 2.207 

description of options 2.210-2.215 

entering options 2.222 
through SYSIPT 2.223 
through SYSLOG 2.222 

example job stream 2.220,2.223 

example of output 2.224 

executing 2.220 

history tapes 2.222 

list of options 2.209 

logical units required 2.208 

operators flowchart, for executing 2.221 

relationship between EREP and SYSREC, illustration 2.1 94 

relationship between EREP and RMS; illustration 2.1 89 

system requirements 2.207 

when to use 2.225 
EREP history tapes 2.216 
EREP options 

description of 2.210-2.215 

list of 2.208,2.209 
Error Checking and Correction (ECC) 2.196 

Modes of 2.197 
Error detection with VSAM macros 4.73 
Error during IPL (flowchart) 3.3 
Error Frequency Limits (EFL) 2.196 

Threshold values 2.196 
Error Queue (ERRQ) 4.60 

examination of 4.60 

format and contents 4.61 

how to locate 4.60 
Error Recovery Procedures (ERP) 2.198 

illustration of system action 2. 1 93 
Error recovery block 4.60 

format and contents 4.61 

how to locate 4.60 
Error Volume Analysis (EVA) 2.202 

description and operation 2.202 

how and when to use 2.202 

system requirements 2.202 
ESERV 2.116 

errors during update 2.1 16 

how to use 2.116 

input to and output from 2.117 

lob stream example A.7 
ESTVUT 2.219 

contents and format output 2.219 

job stream example 2.219 
Examples 

computer output 

ALTER command 2.6 

ALTER/DISPLAY console operation 2.136 

assembler listing showing PIOCS macros 4.64 
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Examples (continued) 

assembler listing showing the expansions of a DTFMT 4.70 

CANCELV 2.121 

DSERV 2.114 

DSPLY command 2.8 

DS PL YV command 2.122 

DUMPconunand 2.11 

EREP output 2.114 

Linkage editor map 2.181 

Locating the active communication region 4.35 

Low address storage 2.175 

LSERV 2.108,2.109,2.110 

LVTOC 2.121 

Job stream trace 2.167 

MAP command 2.169 

PDAID F/L trace 2.47 

PDAID GSVC trace 2.50 

PDAID trace 2.44 

PDAID QTAM trace 2.53 

PDUMP macro 2.33 

RSERV 2.115 

SDAID dump showing how to locate the page 

management tables 4.120 
SDAID initializing output 2.95 
SDAID job entry 2.96 
SDAID output class COMREG 2.98 
SDAID output class FASTREC, AUTOMATIC 2.99 
SDAID output class PAGETAB 2.97 
SDAID BR, IF, GA trace output class PSW 2.100 
SDAID page tracing routine output 2.99 
Stand-alone dump A.11-A.30 
System dump showing isolation of a program check, 

data exception 2.13,2.14 
System dump showing the partition save area 4. 1 06 
System dump showing the CCB 4.78 
System dump showing a DTFMT 4.70 
System status information 2.169 
Transient dump 2.4 

see also job stream examples 

see also Models 1 15/125 display, examples of 

see also Model 158 frames, examples of 

EXCP macro, example of 4.64 
Executing EREP 2.220 

entering options 2.220 
through SYSIPT 2.223 
through SYSLOG 2.222 

table of options 2,209 

operators flowchart 2.221 
Expansion flags for SYSCOM 4.43 
Explanation of SDAID initializing output 2.95 
Explanation of the contents of the AB option table 4.1 02 
Explanation of the contents of 

AB option table 4.102 

ACB 4.76 

Boundary box 4.115 

CCB copy block 4.124 

CCW copy block 4.126 

CCW:TCB 4.127 

Channel Address Word (CAW) 2.171 

Channel Bucket 4.59 

Channel control table 4.59 

Channel control Word (CCW) 4.83 

Channel control table 4.59 

Channel queue 4.57 

Command Control Block (CCB) 4.79-4.81 

DTFMT 4.66 

Error block 4.61 

Error recovery 4,61 

Error queue 4.61 



Page of GC33-S380-1, 
revised September 30, 1974, 
by TNL GN33-8793 



DOS/VS Serviceability Aids and Debugging Procedures 



INDEX E (continued) 



Explanation of the contents of (continued) 
EXLST 4.74 
FICL 4.46 
FLPTR 4.56 
FOCL 4.48 

Interrupt status information 4.109 
IT option request table 4.101 
IT option table 4.100 
Job Information Block (JIB) 4.55 
Label save area 4.108 
Line mode table A. 10 
Low address storage 2.174, 2.175 
LUB 4.47 
NICL 4.46 
OC option table 4.105 
Page Frame Table 4.114 
Page table 4.113 

Partition communication regions 4.35-4.41 
Partition save area 4.108 
PC option table 4.104 
PD area 2.56, 2.57 
PHO option table 4.103 
Program Information Block (PIB) 4.89-4.9 1 
PIB2 4.93 

Program Status Word (PSW) 2.173 
Programmer Unit Block (PUB) 4.48, 4.49 

PUBOWNERSHIP 4.53 
RPL 4.75 
SDarea 2.85 
Segment table 4.113 
System save areas 4.110 
System communication region 4.42, 4.43 
Supervisor transient area 2.195 



FASTREC output, see SDAID output classes 
FAVP 4.54 

how to locate 4.54 
File dump program A.40 
First On Channel List (FOCL) 4.48 

how to locate 4.48 
First In Class List (FICL) 4.46 

how to locate 4.46 
Fix information block 4.128 
Flags for SYSCOM 4.43 
Flowcharts, for the operator 

Action, in event of system malfunction 
during IPL 3.5 
job canceled by system 3.27 
recognized as a wait state 3.16 
recognized as an unintended loop 3.20 
recognized as incorrect output 3.26 
Initial system checks 3.15 
Stop on address compare 2.143 
Models 135/145/155-11 2.144 
Models 115/125 2.146 
Model 158 2.159 
To copy SYSVIS (PDS) to disk 2.24 
To copy SYSVIS (PDS) to tape 2.24 
To dump real storage (Models 115/125 only) 2. 
To execute EREP 2.221 
To execute SEREP 2.227 
To execute the stand-alone dump 2.23 
To initialize PDAID 2.63 
To initialize SDAID 2.89 
To initialize the transient dump 2.29 
To trace a loop by instruction stepping 
Models 135/145/155-11 2.147 
Models 115/125 2.142 
Model 158 2.151 
To use the ALTER/DISPLAY console feature 
Models 135/145/155-11 2.135 
Models 115/125 2.141 



Flowcharts for the operator (continued) 

Model 158 2.145 
Flowcharts, for the programmer 

Error generate during IPL 4.5 

Hard wait with message in low address storage 4.7 

Hard wait with no message in low address storage 4.8 

Incorrect output 4.12,4.13 

Initial checks 4.3 

Job canceled by ILLEGAL SVC 4.25 

Job canceled for other reasons 4.26 

Program check in supervisor 4.27 

Program check in user program 4.19 

Soft wait 4.9 

Unintended loop 4.11 
FLPTR 4,56 

how to locate 4.56 
F/L trace 2.45 

examples of output 2.47 

format and contents of a trace entry 2.45 

tracing options 2.46 

when to use 2.46 
Format of SYSRES 2.104 
Formatting dump 2.19 

example of A.11-A.30 

generating, see DUMPGEN 
Free List Pointer (FLPTR) 

how to locate 
Further error isolation 1.27 



G 

Gathering information 1.17,4.2 

Hardware error recording and recovery 1 .22, 2. 

EREP 1.23,2.210 

Log analy sis display s 1.25,2.230 

Maintenance program selection 1.25, 2.230 

Recovery Management Support (RMS) 1.21, 2.188 

SEREP 1.24,2.226 
Linkage editor 2.181 
Loop tracing 1.20 

see trace routines 

see also tracing loop 
Low address storage 1 . 1 8, 2. 1 7 1 
Operator flowcharts 

on occurrence a program check interrupt 3.29 

when system in loop 3.22 

when system in wait state 3.16 

when system procedures obviously incorrect output 3.28 
Storage dump s 1.19 

see also dumps 

see also serviceability aids from the operator console 
General purpose registers 

Altering the contents of and displaying 

Models 135/145/155-11 2.135 

Models 115/125 2.141 

Model 158 2.145 
Dumping, SDAID output class 2 (GRP) 2.79 

see also dumps 
Displaying 

see ALTER/DISPLAY console operation 

see also dumps 
Usage 4.96 

by DOS/VS 4.96 

by job accounting 4.97 

by POWER 4.97 

byPOWER/RJE 4.97 

for programmer use 4.96, 4.98 

for sub-routine hnkage 4.96 
General register alter trace 2.82 

when to use 2.82 
Generating a stand-alone dump program 2.15 
Generation option table A.50 
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G (continued) 

GSVC trace 2.48 

examples of output 2.50 

format and contents of a trace entry 2.48 

tracing options 2.47 

when to use 2.47 



H 

Hand son debugging 1 . 4 

see also flowcharts, for the operator 
Hard wait 1.10 
causes 1.11 
during IPL 2.177 

isolation of cause (programmers flowchart) 4.7, 4.8 
messages, hst of 2.161, 3.2, 4.6 
operators flowchart 3.14 
Hardware error recording and recovery 1 .21 , 2.1 88 

pictorial representation of 1.22, 2.188 
Hardware Instruction Retry (HIR) 2.197 

Hints for debugging, see debugging hints 
HIST, option of EREP 2.214 
History tapes 2.216 
creating 2.216 
for EREP 2.216 
HISTORY /RDE 2.216 
TES (Tape error statistics) 2.216 
How to copy SYSVIS (the page data set) on disk or tape 

see also SYSVIS dump 
How to locate 

AB option table 4.102 
Boundary box 4. 1 1 5 

example of A. 14 
CCB 4.78 

example of 4.78 
CCB copy block, example of A. 15, A.23 
CCW copy block, example of A. 15, A.23 
CCW/Translation control block 4.127 
Channel bucket 4.58 

example of A. 14 
Channel control table 4.58 
Channel program (CCW) 4.81 

example of 4.78 
CHANQ 4.56 

example of A. 14 
CPU 10, example of 2.95, A.12 
Error recovery block, error block 4.60 

example of A. 14 
ERRQ 4.60 

example of A. 14 
FAVP 4.54 

example of A. 13 
FICL 4.56 

example of A. 13 
FLPTR 4.56 

example of A.12 
FOCL 4.48 

example of A. 13 
Idal block, example of A.15 

example of A.15 
IT option request table 4. 1 1 
IT option table 4.100 
JIB 4.54 

example of A. 13 
Job accounting interface common table A.33 
Job accounting interface partition table A. 32 
Label save area, illustration of 4.107 
LUB 4.56 

example of A. 13 
NICE 4.54 

example of A. 13 
OC option table 4.105 



INDEX 



How to locate (continued) 
Page frame table 4.114 

exampleof 4.119, A.15 
Page table 4.113 

example of 4.119, A.15 
Partition communication regions 

example of 4. 34, A. 1 3 
Partition save area 4.106 

example of 4,106 
PC option table 4.104 
PDarea 2.56 

exampleof 2.44, A. 14 
PD standard preface table A. 14 

exampleof A. 14 
PHO option table 4.103 
PIB 4.88 



4.54 



example of 


A.13 


PIB2 4.92 




example of 


4.34, A.13 


PUB 4.47 




example of 


A.13 


PUBOWNER 


4.53 


SDarea 2.80 




Segment table 


4.112 


example of 


4.119, A.l 



System communication region (SYSCOM) 4.42 
2.126 exampleof 2.160, A.12 

System save areas 4. 1 1 
How to use 

ALTER command 2.6 
ALTER/DISPLAY console operation 

Models 135/145/155-n 2.128 

Models 115/125 2.134 

Model 158 2.145 
DSPLY command 2.8 
DUMP command 2.10 
DUMP macro 2.34,2.35 
EREP 2.192-2.210 
ESERV 2.116 
ESTVUT 2.204 
EVA 2.187 
Control registers, see program event recording 

function of A.6 

see also SDAID parameters changes 
Instruction step 

Models 135/145/155-11 2.139 

Models 115/125 2.141 

Model 158 2.151 
IPL reason inforrnation 2.189 
JDUMP macro 2.34,2.35 
LIOCS 4.65 

MAP command 2.151,2.154 
Models 115/125 dump operation 2.147 
Models 115/125 maintenance log analysis 
Model 158 display frame 2.232 
Option dump, see also system dump 2.12 
Output from the 

DSERV program 2.114 

Library display programs 2.115 

LSERV program 2.102,2.210 

LVTOC program 2.121 

SYSVIS dump program 2.157 

PDAID 2.58,2.62,2.63 

PDAID output, see examples 

PDUMP macro 2.33 

PIK A.3 
PIOCS 4.64 

example of 4.64 
Relocation factor, example of using 2.13, 2.100 
ROD command 2.188 
SDAID 2.86,2.88,2.89 
SDAID output, see examples 
Section 2 of this manual 2.2 
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INDEX H (continued) 

How to use (continued) 

Section 3 of this manual 3.1 
Section 4 of this manual 4.1 
SEREP 2.227 

Models 135/145/155-11 2.226 

Model 158 2.228 
Serviceability aids for POWER/POWER RJE A.35-A.37 
SHOWCB macro 4.73 
Stop on address compare 2.143 

Models 135/145/155-11 2.143 

Models 115/125 2.154 

Model 158 2.159 
SYSLOGID A.3 
System dump 2.13,2.14 
TESTCB macro 4.73 
The linkage editor map 2.13, 2.166 
The stand-alone dump output 2.22, A. 11 
TheTIK A.4 
This manual vii 
Transient dump program 2.25, 2.26 

I 

ID AL block 4.122 
Imperative macros 

forLIOCS 4.65 

forVSAM 4.72,4.73 
Index, visual, of debugging aids 2.3 
Index frame (Model 158) 1.26,2.228 
Incorrect output 

causes 1.13 

definition 1.13 

isolation of cause, programmers flowchart 4.12 

operator action 1.13 

operator flowchart 3.26 

recognizing 1.13 
Indicators for loops and wait states 1.12 
Individual recording 2.201, 2.205 
Information blocks, see supervisor information blocks 
Information recorded on SYSREC, see SYSREC record types 
InitiaUzing output (SDAID) 2.95 
Initializing SDAID Howchart 2.89 
Initial checks for the programmer 4.3 
Initial examination of 

job control language and device assignments 3.15 

job set up, job preparation 3.13 

program preparation 4.3 

stand-alone dump output 2.22 
example of A.11-A.30 
Initial system checks for the operator 3.15 
Instruction stepping, see tracing a loop 

see also SDAID instruction trace 
I/O error during FETCH 2.180 
I/O device malfunctions 1.16 

examples of 1.16 

operator action 1.16 
I/O device type codes 4.50-4.52 
Input /output system, see IOCS 
Instruction trace 2.82 

when to use 2.82 
Intermittent errors 1.14 

definition 1.14 

hardware failures 1.14 

programming errors 1.14 

recording, see RMS 
Interrelationships between 

imperative, declarative and MOD macros 4.69, 4.70 

LIOCS and PIOCS, illustration of 4.63 

original channel program and the copy blocks 4.1 23 

page management tables, illustration of 4.117 

supervisor I/O tables and blocks 4.45 

VSAM control blocks, illustration of 4.74 
Interrupt status information 4.109 



interpreting output from 

a dump containing a CCB 4.78 

a stand-alone dump A.11-A.30 

a system dump 2.14,2.14 

DSERV 2.114 

EREP 2.224 

LSERV 2.110 

LVTOC 2.121,2.122 

PDAID 2.44,2.47,2.50,2.53 

SDAID 2.95,2.100 

The Linkage Editor Map 2.13 

The Linkage Editor diagnostic of input 2.182, 2.1 83 

The MAP command 2.169 

Transient dump 2.31 
IOCS (input/output control system) 4.62-4.76 

see also Logical IOCS 

see also Physical IOCS 

see also Virtual Storage Access Method (VSAM) 
I/O tables 

Access Method Control Block (ACB) 4.76 

CCB copy block 4.122 

CCW copy block 4.126 

CCW Translation Control Block 4.127 

Channel bucket 4.58 

Channel control table 4.58 

Channel queue (CHANQ) 4.56 

Error recovery block 4.60 

Error Queue (ERRQ) 4.60 

Exit List Block (EXLST) 4.74 

Idal block 4.122 

Job Information Block (JIB) 4.54 

Line Mode Table (MT) A. 10 

Logical Unit Block (LUB) 4.46 

Physical Unit Block (PUB) 4.48 

PUBOWNERSHIP 4.53 

Request Parameter List (RPL) 4.75 
I/O Requestors Partition or System Task ID (REQID) A.5 
1/0 Requestors Task Identification (TKREQID) A.5 
I/O Trace 2.42 

examples of output 2.44 

format and contents of a trace entry 2.42 

tracing options 2.43 

when to use 2.43 
IPL/EOD recording 2.203 
IPL error messages 2.177 
IPL errors 2.177 

operators action (flowchart) 3.3 

programmer action (flowchart) 4.5 
IPL reason information codes 2.204 
Isolating errors recognized as 

a hard wait state 4.7, 4.8 

a loop 4.11 

a program check in supervisor 4.25 

a program check in SVA 4.23 

a program check in user program 4.19 

a soft wait state 4.9,4.10 

an error during IPL 4.5 

illegal SVC 4.25 

incorrect output 4. 1 2-4. 1 7 

other reasons 4.26 
IT option request table 4.101 
IT option table 4.100 
Interrelationship between DTP and MOD macros 4.69 



JDUMP macro 2.34 
format of 2.34 
information dumped 2.34 
when to use 2.35 
general description A. 31 
partition table A.3 2 
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J (continued) 

JDUMP macro (continued) 

programming considerations A.34 
Job accounting interface A.32 

common table A.33 
Job control commands and statements 

see commands 

see also statements 
Job Information Block (JIB) 4.54 

examination of 4.54 

explanation of the contents of 4.55 

format of 4.55 

how to locate 4.54 
Job stream examples 

copying SYSVIS to SYSOOl 2.126 

dumping SYSOOl (SYSVIS copy) to SYSLST 2.1 27 

dumping SYSVIS to SYSLST 2.128 

executing CSERV 2.112 

executing DSERV 2.113 

executing DUMPGEN 2.17 

executing ERE? 2.110, 2.113 

executing ESTVUT 2.209 

executing ESERV A.8 

executing LSERV 2.102 

executing LVTOC 2.120 

executing PDAID 

viaSYSIPT 2.68,2.69 
viaSYSLOG 2.70,2.73 

executing PSERV 2.113 

executing RSERV 2.112 

executing SSERV 2.113 

executing SUM option of EREP A.80 

initializing SDAID 2.96 

initializing the transient dump 

process tape error statistics A. 78 
Job stream trace, example of 2.167 



Label information cylinder 2.103 

format and contents 2.103 
for DASD labels 2.107 
for Tape labels 2.106 

function 2.103 

location, on SYSRES 2.104 

track allocation 2.105 
Label information display program (LSERV) 2.102 

example of output 2.108, 2.109, 2.110 

executing 2.102 

system requirements 2.102 

summary of information provided 2.102 

when and how to use 2.102 
Label save areas 4.106,4.107 
Layout of SYSRES 2.104 
Library display programs 2.111 

example of a DSERV output 2.1 14 

example of a RSERV output 2.115 

table of control cards 2.112, 2.113 

when and how to use 2.1 1 1 
LIK A.5 
Linkage editor 2.181 

diagnostic of input 2.182 

error flags 2,182,2.183 

map 2.181 

summary 2.185 
Linkage registers 4.98 
List of flowcharts xi 
List of illustrations xi 
List of Program Interrupt codes 4.109 
List of tables xi 

List of WAIT STATE codes 2.176, 3.3, 3.4, 4.6 
Locating information blocks and save areas, see how to locate 
Locating partition communication regions 4.34 



INDEX 



Locating the POWER partition 

Log analysis displays (Model 115/125) 1.25, 2.230 

Logical IOCS 4.62 

using 4.65 
Logical transietn area 2. 1 95 

dumping, see transient dump 
Logical transient owner identification key (LIK) A.5 
Logical transient key (LTK) A.5 
Logical unit block (LUB) 4.56 

explanation of the contents of 4.47 

format of 4.47 

how to locate 4.46 
Loop tracing 1.20 

instruction step method 2.146 
Models 135/145/155-11 2.147 
Models 115/125 2.149 
Modell58 2.151 

using the SDAID BR and or IF trace, example of 2.100 
Loops, see unintended program loop 
Low address storage 1.18, 2.171 

contents of 2.174 

displaying 2.171 

example of, in a system dump output 2.175 

format of 2.175 

illustration of 1.18 

in a stand-alone dump output 

when to display 2.171 
LTK A.5 



M 

Machine Check Analysis and Recovery (MCAR) 2.196 

general flow of processing (illustration of) 2.192 
after hard machine check interrupt 2.192 
after soft machine check interrupt 2.192 

modes of operation 2.196 
Main storage alter trace 2.82 

when to use 2.82 
Maintenance program selection (Model 115/125) 1.25, 2.230 
Making a back up copy of SYSVIS (PDS), see SYSVIS dump 
Malfunction 

definition 1 .6 

during program testing 1.6 

during single partition operation 1.6 

in a multiprogramming environment 1.6 

using teleprocessing 1.6 
Manual frame (Model 158) 2.150 
MAP command 2.169 

example of 2.167, 2.169 
Map, Unkage editor 2.181 

example of 2.181 
Matching PUB2 space 2.203 
Message 0S041 list of causes 4.24 
Message X'07E6' 2.167 
Messages, during SDAID initiahzation 2.88 

example of 2.96 

to initiate PDAID routines 2.62 
Methods of output 

for PDAID, see PDAID trace routines 

for SDAID, see SDAID trace routines 
Miscellaneous Data Recorder (MDR) 2.200 
MOD macros 4.68 
Model 115/125 display, examples of 

Address Compare 2.147 

ALTER/DISPLAY control registers 2.143 

ALTER/DISPLAY floating point registers 2. 1 42 

ALTER/DISPLAY general registers 2.142 

ALTER/DISPLAY main (real) storage 2.143 

ALTER/DISPLAY protection key 2.143 

ALTER/DISPLAY PSW 2.142 

ALTER/DISPLAY selection 2.139 

ALTER/DISPLAY virtual storage 2.143 
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Model 115/125 display, examples of (continued) 

Instruction Step 2.146 

Main(real) storage dump (Model 115/125 only) 2.160 

Maintenance program selection 1.25, 2.231 

Mode selection 2.139 
Model 115/125 maintenance log analysis 2.230 
Model 158 frames, examples of 

ALTER/DISPLAY frame 2.144 

INDEX FRAME 1.26, 2.228 

MANUAL FRAME 2.150, 2.158 

SEREP FRAME 2.229 
Modes of output, for PDAID 2.40 
Module 4.68 

prefixes for IBM supplied modules 4.68 
Monitor call instruction A.9 
MVCOM macro 4.34 

N 

NICE 4.46 

how to locate 4.46 
Non-critical area 2.18 

locating 2.18 
Non-destroying dump 2.84 

discontinuing (stopping) before completion 2.84 

how to obtain 2.84 

when to use 2.84 
Non-translating dump, example of 2.25 

o 

OC option table 4.105 

Offline debugging, program debugging 1.27, 4.2 

Online Test Executive Program (OLTEP) 2.234 

description and operation 2.235 

features of 2.234 

illustration of 2.234 

uses of 2.234 
Operators video console display unit 1.25 

see also Models 115/125 displays 

see also Model 158 
Operator commands for RMS 2.203 

illustration of 2.189 

Matching PUB 2 space 2.203 

MODE 2.205 

ROD 2.203 
Operators flowcharts, for gathering information 3.3-3.25 

see also flowcharts, for the operator 
Options for CLEAR EREP 2.210 

EDIT 2.210 

HIST 2.214 

List of 2.209 

RDESUM 2.213 

SELECT 2.212 

SUM 2.211 

TES 2.215 
Organization of partition, and label save areas 4.1 07 
Organization of SYSRES 2.104 
Organization of the supervisor, illustration of 4.33 
Output modes (devices) for PDAID 2.40 
Output information 

for PDAID 2,42, 2.45, 2.48, 2.50 

for SDAID 2.78, 2.79, 2.80 



Page frame table 4.114 

example of (in a dump output) 4.119, A.15 

format and contents 4.114 

how to locate 4.114 
Page frame table extension 4.114 

how to locate 4.114 



Page management tables 4. 1 1 2-4.1 19 
boundary box 4.115 

example of dumping using SDAID output class 05 2.97 
example of interpreting in a dump output 4.119, A.15 
interrelationship, illustration of 4.1 17 
Page frame table 4.1 14 
Page frame table extension 4.114 
Page table 4.112 
segment table 4.112 
Page tracing routines 2.8 1 
example of 2.99 
when to use 2.81 
Page Table 4.112 

example of (in a dump output) 4.119, A.15 
explanation of the contents of 4.113 
format of 4.113 
how to locate 4.113 
initialization 4.112 
Page Enqueue Trace 2.76 
Page HandUng Trace 2.76 
Page Translation Exception Trace 2.76 
Parameters 

for PDAID 2.62 
for SDAID 2.88 

for the MODE command 2.205,2.206 
for the Models 1 15/125 RMS, RMSR support 2.1 88 
for the Transient Dump 2.28 
Partition communication regions (COMREGs) 4.34 

how to locate, example of 4.34 
Partition Identification, see PIK 
Partition save area 4.106 

how to locate, example of 4.106 
PC option table 4.104 
PD address table A. 2 

how to locate, see PD area 
PD area 2.56 
dumping 2.56 
format and contents of 2.57 
locating 2.56 
PDAID and SDAID used together (concurrently) 2.40 
PDAID output, see examples 
PDAID trace routines 2.39 
caution before using 2.39 

description and operation of the trace routines 2.42 
dumping the PD area 2.56 
dumping the PDAID alternate area 2.60 
dumping the tape used for PDAID output (PDLIST) 2.41 
error messages 2.61 
F/L trace 2.45 

examples of output 2.47 
format and contents of a trace entry 2.45 
modes and output 2.46 
tracing options 2.46 
when to use 2.46 
General description 2.39 
GSVC trace 2.48 

examples of output 2.50 
format and contents of a trace entry 2.48 
modes of output 2.49 
tracing options 2.49 
when to use 2.49 
Job stream entry examples 
viaSYSIPT 2.69,2.70 
viaSYSLOG 2.72,2.73 
Modes of output 2.40 

core-wrap in an alternate area 2.41 
core-wrap in the PD area 2.41 
line printer 2.40 
magnetic tape 2.40 

when to use core-wrap output mode 2.41 
Operator's flowchart for initializing 2.63 
Printing the tape used for the PDAID output (PDLIST) 2.41 
QTAM trace 2.51 
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P (continued) 

QTAM trace (continued) 
example of output 2.53 
format and contents of a trace entry 2.51 
modes of output 2,52 
tracing options 2.52 
when to use 2.52 

Restrictions 2.40 

Selecting the output device 2.59 
Specifying an alternate area 2.60 

System requirements 2.40 

Table of parameters 2.62 

Terminating 2.41 
PDAID transient dump, see Transient dump 
PDLIST 2.41 
PDUMP macro 2.32 

example of output 2.33 

format of 2.32 

information dumped 2.40 

when and how to use 2.33 
PD standard preface table A. 2 

how to locate, see PD area 
PHO option table 4.103 
PhysicallOCS 4.62 

using 4.64 
Physical transient area 2.195 

dumping, see transient dump 
PIK A.3 
POWER/VS 

Problem analysis for programs running under 4.30 
Service aids for A. 3 9 

File dump program A.40 
PRINT GEN, PRINT NOGEN assembler language statement 

example of 4.70 
Printing the contents of SYSREC, see EREP 
Printing the contents of SYSVIS, see SYSVIS dump 
Printing the tape for PDAID output (PDLIST) 2.41 
Prefixes for IBM modules 4.68 
Processing tape error statistics 

using EREP 2.217 

using EST VUT 2.219 
Program check interrupt 

causes 1.15 

definition 1.15 

example of 2.12,2.13 

isolation of cause, programmers flowchart 4.30 

inSVA 2.12,2.13 

list of codes 4.109 

operation action 1.15 

operator flowchart 3.25 
Program Event Recording (PER) A. 8 
Program Information Block (PIB) 4.88-4.91 

format of 4.89-4.91 

how to locate 4.88 
Program Information Block Extension (PIB2) 4.92, 4.93 

format of 4.93 

how to locate 4.92 
Program Interrupt Key (PIK) A.3 
Programmers flowcharts 4.2 

see also flowcharts 
Programmer Unit Block (PUB) 4.48-4.52 

examination of 4.48 

explanation of the contents 4.49-4.52 i 

format of 4.48 | 

how to locate 4.48 
Programming considerations for the Job Accounting Option A.34 
Program Status Word 2.173 

displaying, dumping, SDAID output class 1 (PSW) 2.74 
see also console ALTER/DISPLAY operation 

format and contents 2.173 

locating 2.175 
PUB2 2.203 
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format of 4.53 
how to locate 4.53 



Queues 

error queue 4.62 

channel queue 4.56 
Quick reference Ust of serviceability aids 2.3 
QTAM trace 2.51 

example of output 2.5 3 

format and contents of a trace entry 2.51 

tracing options 2.52 

when to use 2.52 

R 

R A S transient area 2.195 
RDESUM, option of EREP 2.3 

examples of A. 80 
Real storage areas destroyed by the stand-alone dump program 

example of A. 12 

see also NON-CRITICAL area 
Real storage dump, see SDAID dump routines 
Recommendations for further problem analysis 

see flowcharts for the programmer 
Recognizing a malfunction 

a loop 1.8,1.12,3.12 

a wait state 1.10,1.12,3.12 

hardware error on Model 158 1.26,2.232 

incorrect output 1.13,3.12 

job/program canceled by system 1.15, 3.12 

program check interrupt 1.15,3.12 
Recovery from a hard wait, operators flowchart 2.189, 3.14 
Recovery from a soft wait 
Recovery Management Support (RMS) 2.1 88, 2.206 

components 2.195 

detailed description 2.196 

general description 2.188 

illustration of 2.189 

operation 2,190 

system requirements 2.188 
Recovery Management Support Recorder (RMSR) 2.1 89 

see also SYSREC 
Re-entrant modules 4.68 

Register Alternation, see ALTER/DISPLAY console features 
Reliability, Availability and Serviceability (RAS) 1.21 
ReUability Data Extractor (RDE) see IPL/EOD recording 

see also IPL reason information 

see also ROD command 
Relocation factor, example of using 2.13, 2.100 

see also linkage editor map 
Restrictions, on use of 

ALTER command 2.7 

DSPLY command 2.9 

PDAID 2.40 

PDUMP macro 2.33 

SDAID 2.75 

SYSVIS dump 2.125 
RJE I/O trace A.3 9 

ROD command 2.203 



Save areas 

ABSAVEarea 4.108 

Label save area, illustration of 4.107 

partition and label save area 4.106 

how to locate 4.106 
save areas for job accounting 4.1 11 
system save areas 4.110 
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Save areas (continued) 

user exit routine save areas, illustration of 4.109 
save usage command 2.164 
SDarea 2.85 

SDAID and PDAID used together (concurrently) 2.77 
SDAID initializing output, example of 2.95 
SDAID output, see examples 

SDAID output classes, table of, for the elementary events 2.79 
Output class COMREG, (04) 2.79 

Output class DUMPREAL (Non-destroying dump) (07) 2.79 
Output class FASTREC, (00) 2.79 
Output class GPR, (02) 2.79 
Output class LOCORE, (03) 2.79 
Output class PAGETAB, (05) 2.79 
Output class PDUMP, (08) 2.79 
Output class PSW (01) 2.79 
Output class SUPVISOR, (06) 2.79 
SDAID trace routines 2.73 

altering SDAID parameters after initialization 2.87 

a note to programmers 2.87 

caution before using 2.74 

characteristics 2.76 

description and operation of the routines 2.81 

dump on program check 2.85 

when to use 2.85 
examples of output 

output class COMREG 2.98 

output class FASTREC 2.99 

output class FASTREC, AUTOMATIC 2.98 

output class PAGETAB 2.97 

output class PSW (during BR, IF and GA trace) 2.100 

predefined output 2.99 
General description 2.73 
General register alter trace (GA) 2.82 
Initiahzing 2.86 

example of 2.96 

flowchart 1.89 
Initializing output 2.95 
Instruction trace (IF) 2.82 
Job entry example 2.96 
Messages during Initializing 2.88 

example of 2.96 
Non-destroying dump 2.84 

how to obtain 2.84 

when to use 2.84 
Operators flowchart for initializing 2.84 
Output information 2.78 ( 

Page tracing routines 2.81 
Parameters for initiahzing SDAID 2.88 
PDUMP output class 2.78 
SDAID events 2.77 

SDAID output classes, output information 2.78 
Specifying the area to be traced 2.80 
Stop and dump faciUties 2.75 
Stop and dump routines 2.83 
Stop on address 2.83 
Storage alter trace (SA) 2.82 
Successful branch trace (BR) 2.82 
System requirements 2.75 

Table of output class options for elementary events 2.79 
Table of predefined output for dedicated events 2.80 
Terminating 2.77 
The SDarea 2.85 

Using PDAID and SDAID together 2.77 
Segment table 4.112 

example of (in a dump output) 4.119, A.15 
format and contents 4.1 13 
how to locate 4.112 

interrelationship to page table, illustration of 4.1 17 
SELECT, option of EREP 2.212 
SEREP 1.24,2.226 

Models 135/145/155-11 2.226 



\ 



SEREP (continued) 

ModellSS 2.228 
ServiceabiUty aids 1.3 
resume 1.3 

pictorial representation of 1 .5 

provided by the operators console 2.1 31 

visual index 2.3 

see dumps 

see also trace routines 

see also hardware error recording 
ServiceabiUty aids from the operators console 

ALTER/DISPLAY console operation 2.1 32 

clear real storage 2.163 

instruction stepping 2.146 

Models 115/125 console dump operation 2.160 

Stop on address compare 2.152 
SHOWCB macro 4.73 
Snap shot dump 

PDUMP macro 2.32 

SDAID PDUMP output class 2.78 
Soft wait 1.10 

causes 1.11 

isolation of cause, programmers flowchart 4.10 

operators action, flowchart 3.14 

recovery from 1.11 
Software routines used by RMS 2. 180 
Specifying the area to be traced by SDAID 2.80 
Statements, job control 

LIST 2.170 

LISTIO 2.166,2.167,2.168 

LOG 2.170 

NODUMP 2.170 

NOLIST 2.170 

NOLOG 2.170 

//LISTIO 2.177-2.168 

//OPTION DUMP, see also system dump 2.170 

//PAUSE 2.170 

example of 2.167 
Stand-alone dump 2.18 

a note to operators 2.22 

a note to programmers 2.22 

example of A.11-A.30 

generating, see DUMPGEN 

how to use the output 2.22 

information dumped 2.18, 2.19 

pictorial representation of 2.20, 2.21 

operation 2.18 

operators flowchart 2.23 

when to use 2.19 
Stand-alone EREP, see SEREP 

Standard dump, non-translating dump, example of 2.31 
Status, see MODE command, parameters of 2.206 
Sto p and dum p routines 2.83 

when to use 2.83 
Stop on address (SDAID) 2.83 

see also stop on address compare 
Stop on address compare (all Models) 2.152 

Models 135/145/155-11 2.152,2.153 

Models 115/125 2.156 

Modell58 2.158 

when to use 2.156 

see also data compare trap 
Stop on event (SDAID) 2.75 
Stopping the SDAID non-destroying dump 2.84 
Storage alternation 

using the ALTER command 2.6 

using the ALTER/DISPLAY console feature 2.1 32 
Storage areas destroyed by the stand-alone dump program 2.22 

example of A. 12 

see also non-critical area 
Storage dumps, pictorial representation of 1.19 

see also dumps 
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Store status 2.162 

Sub-system ID, see IPL reason information 

Successful branch trace 2.82 

example of output 2.100 

when to use 2.82 
Supervisor call trace, see GSVC trace 
Supervisor calls 4.84 

function 4.84 

list of 4.85-4.87 
Supervisor communication macros 2.32 

JDUMP macro 2.34 

PDUMP macro 2.32 

DUMP macro 2.34 
Supervisor information blocks 

PIB 4.88 

PIB extension (PIB2) 4.88 

see also page management tables 

see also supervisor I/O tables 
Supervisor I/O tables 

CCB copy block 4.122 

CCW copy block 4.126 

CCW/TCB 4.128 

Channel Bucket 4.58 

Channel Control Table 4.58 

Channel Queue 4.56 

Error Recovery Block, Error Block 4.60 

Error Queue 4.60 

FAVP 4.54 

FICL 4.46 

Fix information block 4.128 

FLPTR 4.56 

FOCI 4.48 

ID AL block 4.122 

Interrelationship illustration of 4.45 

JIB 4.56 

LMT A. 10 

LUB 4.46 

NICE 4.46 

PUB 4.48 

PUBOWNERSHIP 4.50 
Supervisor, organization of 4.33 
Supervisor tables, see supervisor I/O tables 
Summary of error checking for VSAM imperative macros 4.73 
SVC trace, see GSVC trace 
SYSLOGID a.3 
SYSREC 2.199 

creating 2.199 

record types 2.199 

counter overflow record 2.200 
forCCH 2.199 
forMCAR 2.199 

IPL/EOD 2.200 

MDR 2.200 

RDE 2.200 

Tape volume dismount record 2.200 

Unit check record 2.200 

Relationship 

between SYSREC record types and EREP 2.194 
SYSRES extent, format and contents 2.104 
System communication region (SYSCOM) 4.42 

format of 4.42,4.43 

how to locate 4.42 
System dump 2.12 

example of 2.13, 2.14 

how to interpret, example of 2.13, 2.14 

when to use 2.12 
System information required 

to isolate the cause of malfunctions 4.2 
System recorder file, see SYSREC 
System requirements for 

EREP 2.207 

EVA 2.202 



LSERV 2.102 

PDAID 2.40 

SDAID 2.75 

RMS 2.188 

TES 2.201 

Transient dump 2.25 
System save areas 4.110 
System status information, example of 2.184 
SYSVISdump 2.125 

description and operation 2.125 

error messages 2.129 
examples of 2.129 

how to execute 2.126 

example job streams 2.125, 2.127, 2.128 

how to use the dump output 2.130 

operators flowchart 2.24 

restriction 2.125 

terminating 2.129 

when to execute 2.130 



Tables, list of, xi 
Table of contents for 

Appendixes A.l 

Section 1 1.1 

Section 2-A 2.5 

Section 2-B 2.37 

Section 2-C 2.101 

Section 2-D 2.131 

Section 2-E 2.165 

Section 2-F 2.187 

Section 3 3.1 

Section 4, Part 1 4.1 

Section 4, Part 2 4.32 

This manual (overall contents) iv 
Task Interrupt Key (TIK) A.3 
Tape Error Statistics (TES) 2.201 

for magnetic tape volumes 2.201 

options for 2.208 

system requirements 2.201 
Terminating 

PDAID 2.41 

PDAID core-wrap in alternate area 2.41 

SDAID 2.77 

The transient dump 2.27 

SYSVISdump 2.129 
TES, option of EREP 2.215 
TESTCB macro 4.73 
Threshold values for EFL 2.196 
Trace routines 2.39 

PDAID 2.39 

SDAID 2.73 
Tracing a loop 

instruction step method 

for the Models 135/145/155-11 2.147 
for the Models 115/125 2.149 

using the SDAID BR/IF TRACE, example of 2.100 
Transient areas (illustration of) 2.195 
Transient dump 2.23 

example of output 2.3 1 

information dumped 2.25 

initializing 2.26 

job stream example 2.30 

operators flowchart 2.29 

selecting the output device 2.27 

system requirements (as for PDAID) 2.40 

table of operands 2.28 

terminating 2.27 

when to use 2.27 
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Transient routines (A, B and R transients) 2.195 
Translating addresses, see converting addresses 
Translating dump, example of 2.1 1 , 2.1 2, A.l 1-A.30 
Translation exception trace, see page tracing routines 
Types of malfunctions 

incorrect output 1.13 

intermittent errors 1.14 

I/O device malfunctions 1.16 

loops 1.8 

program check interrupt 1.15 

wait status 1.10 



u 

Unintended program loop 

causes 1.8 

definition 1.8 

isolation of cause, programmers flowchart 4.1 1 

operator action 1 .9 

operator flowchart 3.20 

recognizing 1.8 

types of 1.8 
Unrecoverable I/O error during FETCH 
User exit routine save areas 4.108 

illustration of 4.109 
User exit routine support, tables used by 4.99-4.105 

Abnormal Termination (AB) 4.102 

Internal Timer option (IT) 4.100, 4.101 

Operator Communication (OC) 4.105 

Page Fault Handling Overlap (PHO) 4.103 

Program Check (PC) 4.104 
Using LIOCS 4.65 

Using PDAID and SDAID concurrently 2.40 
Using PIOCS 4.64 
Using SDAID and PDAID concurrently 2.77 



Video display unit Models 115/125 

example of displays, see Models 115/125 displays 
Virtual storage, organization of 4.33 
Virtual Storage Access Method (VSAM) 4.72 

access method control block 4.76 

declarative macros 4.72 

error detection using VSAM macros 4.73 

exit list 4.74 

imperative macros 4.72 

relationship of control blocks 4.74 

Request Parameter List (RPL) 4.75 

RPL debugging hints 4.72 

SHOWCB and TESTCB macros 4.73 

summary of error checking for VSAM imperative macros 4.73 
Visual Display Unit, see Models 115/125 displays 

see also Model 158 frames 
Volume Table of Contents (VTOC) 2.118 

contents of 2.118 

function of 2.118,2.119 
Volume Table of Contents display program (LVTOC) 2.1 1 8 

example 2.121 

executing 2.120 



w 

Wait states 

causes of a soft wait 1.11 

coded messages, list of 2.176 

definition 1.10 

due to a hardware failure 2.180 

during IPL 2.177 

during program operation 2.178 

isolation of cause, programmers flowchart 4.7 

location of 2.176 

operator action 1.11 

operators flowchart 3.16 

recognizing 1 . 10 

types of 1.10 
Wait macro, example of 4.64 
Wait state messages 2.176 

during IPL 2.177 

during program execution 2.178 

list of 2.176,3.3,3.4 
When to use 

ALTER/DISPLAY console operation 2.132 

Error volume analysis 2.202 

General Register Alter Trace 2.82 

Instruction step console operation 2.146 

LISTIO and //LISTIO 2.166 

Model 125 console dump operation 2.160 

Model 125 save usage counters 2.162 

PDAID core-wrap output mode 2.41 

PDAID F/L trace 2.46 

PDAID GSVC trace 2.49 

PDAID I/O trace 2.43 

SDAID dump on program check 2.85 

SDAID instruction trace 2.82 

SDAID main storage alter trace 2.82 

SDAID non-destroying dump 2.84 

SDAID page tracing routines 2.81 

SDAID stop on address 2.83 

SDAID stop on event 2.83 

SDAID successful branch trace 2.82 

SEREP 2.111 

Stop on address compare console operation 2.152 

Store status function 2.162 

The ALTER command 2.7 

The DSPLY command 2.9 

The D UMP command 2.11 

The DUMP macro 2.35 

The ESERV program 2.117 

The JDUMP macro 2.35 

The Library Display Programs 2.111,2.115 

The LSERV program 2. 102 

The LVTOC program 2.120 

The MAP command 2.166 

The PDAID transient dump 2.27 

The PDUMP transient dump 2.27 

The ROD command 2.204 

The Stand-alone dump 2.19 

The System dump 2.12 

The SYS VIS dump 2.130 

The // OPTION DUMP statement 2.12 

Wrap- Around tracing 2,80 

see also PDAID core-wrap output 



